Авторизация и формат запросов для API экспорта аналитики

Авторизация

Для аутентификации API-запросов используйте секретный API-ключ в заголовке Authorization. Его можно найти в App Settings. Формат: Api-Key {YOUR_SECRET_API_KEY}, например: Api-Key secret_live_....

API-ключи привязаны к конкретному приложению. Если у вас несколько приложений, используйте для каждого отдельный ключ.

Формат запроса

Заголовки

Запросы к серверному API требуют определённых заголовков и тела в формате JSON. Используйте следующие параметры для формирования запросов:

ЗаголовокОписание
Content-Type(Обязательный) Укажите application/json, чтобы API обработал запрос.
Adapty-Tz(Необязательный) Укажите временную зону для определения способа группировки и отображения данных. Используйте формат базы данных часовых поясов IANA (например, Europe/Berlin).

Тело запроса

API ожидает тело запроса в формате JSON с необходимыми данными.

Ограничения по частоте запросов

Максимум — 2 запроса в секунду на один API-ключ. При превышении этого лимита возвращается ошибка 429 Too Many Requests.

Ротация API-ключей

Если нужно сменить секретные API-ключи:

  1. В разделе Settings → General нажмите Generate new key, затем нажмите значок корзины рядом со старым ключом.
  2. Обновите ключ в своём приложении.

Что дальше: Запросы: