Что дает вам подключение
Подключение вашего собственного ключа Ahrefs означает, что SEO-данные для ваших сайтов загружаются с использованием вашей учетной записи Ahrefs, а не нашей. Вы видите те же метрики на своей панели управления, которые берутся из вашей собственной подписки.
Перед началом работы
Тарифный план Ahrefs, включающий доступ к API, а также права владельца или администратора в рабочей области Ahrefs — только они могут создавать ключи API.
1. Создайте ключ в Ahrefs
В Ahrefs откройте Account settings → API keys и создайте ключ. Каждый ключ действует один год, после чего перестает работать; на странице отображается дата истечения срока действия каждого ключа. На этой же странице вы также можете установить лимит на количество единиц API, которое ключ может использовать каждый месяц.
2. Подключите его здесь
Откройте Integrations на панели управления и выберите Connect an account. Выберите Your own SEO data в качестве группы и Ahrefs в качестве учетной записи, заполните поле API key и нажмите Connect account.
Мы проверяем то, что вы вставляете, до того, как что-либо будет сохранено. Неработающий ключ никогда не сохраняется, а в ответе указывается, что именно было с ним не так. Рабочий ключ хранится в зашифрованном виде в нашем хранилище секретов — никогда в нашей базе данных — и больше никогда не показывается, даже вам.
Что происходит дальше
- Проверки авторитета и обратных ссылок, которые мы выполняем для ваших сайтов, используют ваш ключ в рамках квоты вашего тарифного плана и перестают использовать нашу. Мы не берем с вас плату за проверки, выполняемые с помощью вашего ключа.
- Если ваш ключ отозван или его квота исчерпана, мы останавливаемся и показываем вам это на экранах, где отображаются метрики, вместо того чтобы тихо переключаться обратно на нашу учетную запись. Исправьте ключ у поставщика или отключите его, чтобы вернуться к тому, что входит в ваш тарифный план.
- Проверки выполняются по обычному расписанию; подключение ключа не вызывает шквала вызовов к вашей квоте.
Если подключение не удается
Он перестал работать через год. Ключи Ahrefs истекают через двенадцать месяцев. Создайте новый и подключите его.
Проверки останавливаются с сообщением о лимите. Месячный лимит единиц API для ключа или лимит вашего тарифного плана исчерпан. Увеличьте лимит в Account settings → API keys или дождитесь его обновления.
Сообщение о том, что ключ отклонен. Почти всегда это одно из трех: случайно скопированный пробел или разрыв строки, истекший срок действия ключа, либо отзыв или повторная генерация ключа после его копирования. Создайте новый ключ и вставьте его снова.
Подключение происходит, но что-то позже завершается ошибкой. Ключ проходит аутентификацию, но у него отсутствуют разрешения, необходимые для выполнения действия. Создайте новый ключ с разрешениями, указанными выше, затем отключите старое соединение и подключите новый ключ.
Отключение
Откройте Integrations, найдите учетную запись и нажмите Disconnect. Это сразу удаляет сохраненный ключ. Все, что использовало его, останавливается при следующем действии, и экраны, которые зависели от него, сообщают об этом, вместо того чтобы завершаться с ошибкой без предупреждения.
Отключение не отменяет то, что уже было сделано — записи, развертывания или настройки, которые мы изменили в вашей учетной записи, остаются прежними. Если вы подозреваете, что сам ключ мог быть скомпрометирован, также аннулируйте его у поставщика; отключение удаляет нашу копию, а не их.