Статті допомогиДовідник API
Початок
З чого початиЧасті питанняТарифи
ТарифиРекламодавцям
Запуск кампанійПаблішерам
Сайт і рекламний тегГроші
Депозити та виплатиАкаунт
Безпека акаунтаРозробникам
Довідник APIПравове
Умови використанняПолітика конфіденційностіДовідник API
REST API v1: автентифікація, статистика, кампанії, баланс і зони, а також S2S-постбеки конверсій та макроси.
REST API Adgora дозволяє програмно читати статистику, отримувати та ставити на паузу кампанії, перевіряти баланси й отримувати список зон. Базовий URL: https://api.adgora.net. Усі відповіді — у форматі JSON.
Автентифікація
Створіть пару ключів у профілі (секрет показується один раз). Передавайте її в кожному запиті /v1:
Authorization: Bearer {public_key}:{secret}Ліміт запитів — 120 на хвилину на акаунт; за перевищення повертається 429 із заголовком Retry-After. Ключі мають скоупи (stats, campaigns, balance, zones); за відсутності потрібного — 403.
Ендпоінти
| Метод і шлях | Скоуп | Повертає |
|---|---|---|
GET /v1/balance | balance | баланси рекламодавця та паблішера в USD |
GET /v1/stats?days=7 | stats | рядки за днями (додайте role=publisher для вигляду паблішера) |
GET /v1/campaigns | campaigns | ваші кампанії |
POST /v1/campaigns/{id}/pause | campaigns | ставить кампанію на паузу |
POST /v1/campaigns/{id}/resume | campaigns | відновлює кампанію |
GET /v1/zones | zones | ваші зони паблішера |
Приклад
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"S2S-постбек конверсій
Щоб трекати CPA-конверсії, викликайте URL постбека із сервера рекламодавця в момент конверсії. Макрос {clickid} передається на ваш лендинг в URL кліку — збережіть його та надішліть назад:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status: confirmed, delivered, rejected або returned; order_ref — ваш необов'язковий ID замовлення. Секрет офера — на сторінці офера.
Макроси URL лендінга
Додайте їх в URL лендінга креатива — Adgora підставить значення під час кліку:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Зберіть запит
Оберіть ендпоінт і параметри — команда оновлюється одразу. Ключі лишаються заглушками: не вставляйте секрет на вебсторінки.
curl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"