Ошибки и лимиты API

Формат ошибки

Ошибка приходит с кодом 4xx и телом {"error": "текст"} — текст можно показывать пользователю.

Коды

401 — нет токена или он неверный; 403 — недостаточно прав (например, гостевой доступ на просмотр); 404 — проект или запрос не найден или недоступен этому токену; 400 — неверные параметры, например период больше года; 402 — превышен лимит тарифа; 429 — слишком много запросов.

Лимит

Не больше 120 запросов в минуту на один токен. Для больших выгрузок используйте постраничную загрузку позиций через limit и offset вместо сотен мелких запросов.

Пример

HTTP/1.1 401
{"error": "Нужен заголовок Authorization: Bearer <токен из настроек API>"}