Справочник API

На этой странице — общие правила работы с API Tracehub: как аутентифицироваться и по каким принципам устроены запросы и ответы. Описание конкретных методов — на страницах «Экспорт данных» и «API-токены».

Аутентификация

Программный доступ к API идёт по персональным токенам (PAT) — см. страницу API-токены. Каждый запрос несёт два заголовка:

curl "https://api.tracehub.ru/export/installs?app_id=APP_ID&date_from=2026-08-01&date_to=2026-08-15" \
  -H "Authorization: Bearer tracehub_pat_xxxxxxxxxxxxxxxx" \
  -H "X-Tenant-Id: TENANT_ID"

Заголовок	Значение
Authorization	Bearer + секрет токена (tracehub_pat_…)
X-Tenant-Id	ID организации, в которой выполняется запрос

Готовый cURL с подставленным ID организации собирается в кабинете: Данные → Экспорт. Токен должен быть привязан к этой организации и нести право, которое требует метод (для выгрузок — export:read).

Принципы

• Права токена — подмножество ваших. Токен не может больше, чем роль его владельца в организации.
• Ошибки — машиночитаемые. Ответы с ошибкой приходят в формате RFC 9457 (problem details): status, title, detail — показывайте detail, он объясняет причину.
• Лимиты. По умолчанию 100 запросов в час на токен; окна выгрузок и пагинация ограничены — см. «Лимиты» на странице Экспорт данных.
• Большие объёмы — файлами. Синхронные методы предназначены для интерактивных срезов; полные выгрузки выполняются асинхронными заданиями с готовым файлом по ссылке.

По токену с соответствующими правами доступны Pull API и файловые выгрузки — см. страницу Экспорт данных.