Skip to main content

API-ключ

Все запросы требуют заголовок Authorization.
1

Получите ключ

Откройте личный кабинет партнёра и перейдите в Tools -> API (partners.onlytraffic.com/tools/api). На странице перечислены ваши ключи: до 5 активных ключей на аккаунт, у каждого есть имя.Нажмите Create key и выберите имя, уровень доступа (Full или Read-only) и срок действия (30, 90, 180 или 365 дней, либо бессрочно). Ключ показывается один раз, сразу после создания: скопируйте его немедленно. Позже страница показывает только его префикс (ot_partners_ab12…), уровень доступа, срок действия и время последнего использования.Ключ выглядит как ot_partners_ и 40 hex-символов после него. Ключ можно отозвать в любой момент: интеграции, которые его используют, сразу перестают работать, а отзыв освобождает один из 5 слотов.Если у аккаунта остался старый единственный ключ (формат XXXXX-XXXXX-XXXXX-XXXXX), он показан на той же странице как Legacy key. Он продолжает работать с полным доступом, пока вы его там не удалите.
2

Добавьте заголовок

Передавайте ключ в каждом запросе:
Форма с Bearer тоже принимается:
Ключ Full читает ваши данные и может запускать и останавливать кампании. Храните каждый ключ в секрете; для интеграций, которым нужно только чтение, используйте ключ Read-only.

AI-ассистенты

Эти же ключи используют AI-ассистенты. Когда вы подключаете Claude или ChatGPT к аккаунту, вы выбираете один из ключей (или создаёте новый) на странице согласия, никуда его не вставляя. Ассистент получает ровно уровень доступа этого ключа, а отзыв ключа отключает ассистента. См. AI-ассистенты.

Уровни доступа

Истёкшие и отозванные ключи отклоняются так же, как неизвестные: error_code 403, сообщение Error! Access denied. Лимиты запросов считаются на аккаунт, а не на ключ: все ключи аккаунта делят одни и те же 120 чтений / 30 записей в минуту.

Base URL

Пример запроса

Лимиты запросов

Лимиты действуют на аккаунт и общие для всех его ключей: 120 запросов в минуту для эндпоинтов чтения и 30 в минуту для эндпоинтов записи. При превышении лимита ответ содержит error_code 429 и заголовок Retry-After с числом секунд, которое нужно подождать.

Ошибки

Все ответы возвращают HTTP 200. Фактический результат смотрите в поле status.