Авторизация и формат запросов для 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.
Adapty также ограничивает общий трафик API по всем приложениям, поэтому запрос может иногда завершаться ошибкой 429, даже если ваше приложение не превысило собственный лимит. В ответе отсутствует заголовок Retry-After. Чтобы восстановить работу, подождите до минуты, а затем повторите запрос с экспоненциальной задержкой.
Ротация API-ключей
Если нужно сменить секретные API-ключи:
- В разделе Settings → General нажмите Generate new key, затем нажмите значок корзины рядом со старым ключом.
- Обновите ключ в своём приложении.
Что дальше: Запросы: