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 тоже принимается:AI-ассистенты
Эти же ключи используют AI-ассистенты. Когда вы подключаете Claude или ChatGPT к аккаунту, вы выбираете один из ключей (или создаёте новый) на странице согласия, никуда его не вставляя. Ассистент получает ровно уровень доступа этого ключа, а отзыв ключа отключает ассистента. См. AI-ассистенты.Уровни доступа
Истёкшие и отозванные ключи отклоняются так же, как неизвестные:
error_code 403, сообщение Error! Access denied.
Лимиты запросов считаются на аккаунт, а не на ключ: все ключи аккаунта делят одни и те же 120 чтений / 30 записей в минуту.
Base URL
Пример запроса
Лимиты запросов
Лимиты действуют на аккаунт и общие для всех его ключей: 120 запросов в минуту для эндпоинтов чтения и 30 в минуту для эндпоинтов записи. При превышении лимита ответ содержитerror_code 429 и заголовок Retry-After с числом секунд, которое нужно подождать.
Ошибки
Все ответы возвращают HTTP200. Фактический результат смотрите в поле status.
403 — Доступ запрещён
403 — Доступ запрещён
404 — Не найдено
404 — Не найдено
422 — Некорректные параметры
422 — Некорректные параметры
429 — Лимит запросов
429 — Лимит запросов
500 — Ошибка сервера
500 — Ошибка сервера
503 — Сервис временно недоступен
503 — Сервис временно недоступен