Як це працює

Ahrefs Connect дає вашому застосунку доступ до даних Ahrefs API від імені користувача, який підключає свій обліковий запис Ahrefs до вашого продукту.

Ось базова схема роботи:

1. Ваш застосунок інтегрується з Ahrefs API через OAuth.
2. Спільний користувач із платною підпискою Ahrefs підключає свій обліковий запис до вашого застосунку.
3. Ваш застосунок запитує дані Ahrefs від імені цього користувача.
4. Кожен запит витрачає одиниці API з щомісячного ліміту цього користувача.
5. Ви обробляєте, зберігаєте та відображаєте ці дані у своєму застосунку для цього користувача.

Вимоги до участі

Щоб приєднатися до Ahrefs Connect, ваш застосунок має:

• Бути публічно доступним продуктом із наявною базою користувачів. Якщо вам потрібні дані Ahrefs для особистого або внутрішнього використання, слід використовувати Ahrefs API безпосередньо.
• Не конкурувати з Ahrefs напряму і не копіювати наш функціонал.
• Запитувати дані лише від імені окремих користувачів Ahrefs із платними обліковими записами. Ahrefs Connect не призначений для продуктів, які хочуть показувати дані Ahrefs широкій аудиторії, якщо кожен глядач при цьому не є користувачем Ahrefs.

Процес

1. Заявка

Подайте форму заявки разом із:

• Описом вашого продукту
• Посиланням на ваш вебсайт
• Деталями щодо того, як ви плануєте використовувати дані Ahrefs у своєму застосунку

Наша команда Enterprise підтвердить, чи відповідає ваш продукт вимогам, пояснить процес і надасть допомогу.

2. План Enterprise

Якщо ви створюєте нову інтеграцію (не в межах застарілої програми), вам знадобиться план Ahrefs Enterprise, щоб активувати інтеграцію в продакшені.

• План не потрібен під час розробки.
• Щоб інтеграція працювала для користувачів у продакшені, її потрібно ввімкнути.

Наша команда з продажів допоможе вам на цьому кроці.

3. Розробка

Після налаштування ви знайдете розділ Ahrefs Connect у Налаштуваннях акаунта. На цій сторінці наведено деталі реалізації OAuth:

• Ідентифікатори клієнта та секрети
• Поля для налаштування Redirect URI для середовищ staging і production

На цьому етапі статус вашого застосунку буде Неактивний, що дасть змогу:

• Тестувати OAuth-потоки у вашому середовищі staging
• Надсилати безкоштовні тестові запити до ендпойнтів API v3

Ресурси:

• Документація API v3
• Безкоштовні тестові запити
• Посібник із реалізації OAuth

Якщо під час розробки виникнуть запитання, звертайтеся на [email protected] або до менеджера з продажів, з яким ви спілкувалися.

4. Відгук

Коли розробку буде завершено, повідомте нашу службу підтримки або команду продажів. Вони нададуть інструкції щодо подання заявки та деталі вимог до затвердження.

Докладніше: Процес схвалення

5. Активація

Після схвалення ваш застосунок перейде в статус Активний. Це дає змогу:

• Реальні OAuth-підключення для користувачів Ahrefs у продакшені
• Повний доступ до API-запитів у продакшені

Наша команда продажів також може додати ваш застосунок до Галереї застосунків, щоб користувачам було легко його знайти. Для цього потрібно надати додаткові дані для лістингу: Посібник із Галереї застосунків