Skip to content

API-ключи ​

API-ключ позволяет вашим скриптам и серверам работать с API Adexium от имени вашего аккаунта:

Перед началом ​

Доступ к API включает ваш менеджер. Пока он выключен, на вкладке API keys в аккаунте написано «API access is off for your account» — напишите менеджеру.

Создать ключ ​

  1. Откройте Аккаунт → API keys: кабинет рекламодателя · кабинет паблишера.
  2. Нажмите New key и заполните:
    • Название — для чего ключ, например Скрипт отчётов.
    • Скоупы — что ключу можно (см. ниже). Давайте каждому ключу только то, что ему нужно.
    • Срок — 7 дней, 30 дней, 180 дней, 1 год или без срока.
    • Код двухфакторного входа — если он включён в вашем аккаунте.
  3. Скопируйте ключ.

Ключ показывается только один раз

Мы храним лишь отпечаток (хеш) ключа, поэтому показать его повторно не может никто — в том числе мы. Если ключ потерялся, отзовите его и создайте новый.

Ключ выглядит так: axk_3f9a1c2e_5b7d…. В списке видно только его начало (axk_3f9a1c2e…), а также название, скоупы, дата создания, когда и с какого IP им последний раз пользовались и когда он истекает.

Скоупы ​

СкоупАккаунтРазрешает
campaigns:readрекламодательсписок и карточки кампаний, их источники и статистику; справочники таргетинга
campaigns:writeрекламодательсоздавать и менять кампании, запускать и ставить на паузу, управлять источниками, загружать креативы
account:readрекламодательбаланс
widgets:readпаблишерстатистика виджетов
widgets:writeпаблишерсоздание виджетов

Скрипту, который только забирает статистику, хватает скоупа :read. Если такой ключ утечёт, изменить им ничего нельзя.

Срок действия ​

Истёкший ключ сразу перестаёт работать. За 7 дней до окончания вкладка API keys предупреждает об этом — создайте новый ключ и заранее переключите на него скрипт. Ключ без срока работает, пока вы его не отзовёте.

Как использовать ключ ​

Передавайте его в заголовке Authorization каждого запроса:

http
Authorization: Bearer axk_3f9a1c2e_5b7d…

Ключ рекламодателя — список ваших кампаний:

bash
curl 'https://api.adexium.io/api/v1/campaigns' \
  --header 'Authorization: Bearer <ВАШ_API_КЛЮЧ>'

Ключ паблишера — статистика виджета по странам:

bash
curl 'https://api.adexium.io/api/v1/widget/stats/<ID_ВИДЖЕТА>?startDate=2026-11-01&endDate=2026-11-07&viewBy=country' \
  --header 'Authorization: Bearer <ВАШ_API_КЛЮЧ>'

Ошибки ​

ОтветЧто значит
401Нет заголовка Authorization
400 Unable to authorizeКлюч неизвестен, отозван или истёк, либо у аккаунта выключен доступ к API
403 This API key does not have the … scopeКлюч есть, но этот запрос ему не разрешён — создайте ключ с нужным скоупом

Как хранить ключи ​

  • Отдельный ключ на каждый скрипт или сервер — тогда один можно отозвать, не останавливая остальные.
  • Никогда не вставляйте ключ в код сайта или мобильного приложения, в публичный репозиторий или в чат.
  • Отзывайте ключи, которыми больше не пользуетесь. Если ключ мог утечь, отзовите его сразу — он перестанет работать в ту же секунду.
  • Не больше 10 активных ключей на аккаунт.

Ключи, выданные менеджером ​

Менеджер может выпустить ключ за вас — партнёры обычно так и получают первый ключ. Такой ключ помечен issued by your manager, работает по тем же правилам, и вы можете отозвать его в любой момент.

Ключи, созданные до ноября 2026 года, продолжают работать. У них нет срока и есть все скоупы вашего типа аккаунта; лучше заменить их ключами только с нужными скоупами.