TargetlyAPI Referencev1

Targetly Reports API

REST API для получения статистических данных по рекламным кампаниям. Все запросы возвращают JSON.

Base URLhttps://api.targetly.ru/v1
AuthBearer Token
Rate limit100 req/min
Content-Typeapplication/json
POST/auth/token

Получение токена

Аутентификация по API-ключу. Токен действителен 24 часа. Генерация ключа доступна в личном кабинете → Настройки → API. Scope токена ограничен правами чтения отчётов.

Параметры

ПараметрТипОписание
api_keyrequiredstringAPI-ключ из личного кабинета

Тело запроса

Request BodyJSON
{
  "api_key": "sk_live_9a8b7c6d5e4f3a2b1c0d..."
}

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

cURLbash
curl -X POST https://api.targetly.ru/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"api_key": "sk_live_9a8b7c6d5e4f..."}'

Пример ответа

Response200 OK
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOi...",
  "expires_at": "2026-03-20T15:30:00Z",
  "scope": "reports:read"
}

Примечания

Токен передаётся в заголовке Authorization: Bearer <token> во всех последующих запросах.
При истечении токена API вернёт 401 Unauthorized — запросите новый токен.
Ключи начинающиеся с sk_test_ работают в sandbox-окружении без реальных данных.