API-ключи
API-ключ позволяет вашим скриптам и серверам работать с API Adexium от имени вашего аккаунта:
- Рекламодателям — Developer API: кампании, креативы, статистика, баланс.
- Паблишерам и SSP-партнёрам — статистика виджетов и создание виджетов.
Перед началом
Доступ к API включает ваш менеджер. Пока он выключен, на вкладке API keys в аккаунте написано «API access is off for your account» — напишите менеджеру.
Создать ключ
- Откройте Аккаунт → API keys: кабинет рекламодателя · кабинет паблишера.
- Нажмите New key и заполните:
- Название — для чего ключ, например Скрипт отчётов.
- Скоупы — что ключу можно (см. ниже). Давайте каждому ключу только то, что ему нужно.
- Срок — 7 дней, 30 дней, 180 дней, 1 год или без срока.
- Код двухфакторного входа — если он включён в вашем аккаунте.
- Скопируйте ключ.
Ключ показывается только один раз
Мы храним лишь отпечаток (хеш) ключа, поэтому показать его повторно не может никто — в том числе мы. Если ключ потерялся, отзовите его и создайте новый.
Ключ выглядит так: axk_3f9a1c2e_5b7d…. В списке видно только его начало (axk_3f9a1c2e…), а также название, скоупы, дата создания, когда и с какого IP им последний раз пользовались и когда он истекает.
Скоупы
| Скоуп | Аккаунт | Разрешает |
|---|---|---|
campaigns:read | рекламодатель | список и карточки кампаний, их источники и статистику; справочники таргетинга |
campaigns:write | рекламодатель | создавать и менять кампании, запускать и ставить на паузу, управлять источниками, загружать креативы |
account:read | рекламодатель | баланс |
widgets:read | паблишер | статистика виджетов |
widgets:write | паблишер | создание виджетов |
Скрипту, который только забирает статистику, хватает скоупа :read. Если такой ключ утечёт, изменить им ничего нельзя.
Срок действия
Истёкший ключ сразу перестаёт работать. За 7 дней до окончания вкладка API keys предупреждает об этом — создайте новый ключ и заранее переключите на него скрипт. Ключ без срока работает, пока вы его не отзовёте.
Как использовать ключ
Передавайте его в заголовке Authorization каждого запроса:
Authorization: Bearer axk_3f9a1c2e_5b7d…Ключ рекламодателя — список ваших кампаний:
curl 'https://api.adexium.io/api/v1/campaigns' \
--header 'Authorization: Bearer <ВАШ_API_КЛЮЧ>'Ключ паблишера — статистика виджета по странам:
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 года, продолжают работать. У них нет срока и есть все скоупы вашего типа аккаунта; лучше заменить их ключами только с нужными скоупами.