Public API

Диагностика 401, 403, 422 и 429

401 означает, что ключ вообще не приняли. 403 означает, что ключ приняли, но операция не разрешена. 422 означает, что запрос поняли, а payload оказался неправильным. 429 означает превышение rate limit: нужна пауза, а не немедленный повтор.

Проверено 20 августа 2026 г.

Шаги

1. На 401 проверьте, что ключ существует, не просрочен и отправляется в том заголовке, в котором вы думаете, — обычно причина в обрезанном копировании.
2. На 403 прочитайте code: не хватает scope, адрес вне allow-list или ключ принадлежит другому workspace. Переподключение не поможет — нужно изменить права.
3. На 422 прочитайте поле, которое называет ответ, и исправьте payload.
4. На 429 соблюдайте заголовки rate limit и сделайте паузу. Немедленный повтор только ухудшает ситуацию.
5. Сохраните requestId из ответа — именно он даёт поддержке найти ваш конкретный вызов.

Как проверить результат

Тот же запрос после исправления проходит, и ответ имеет статус 2xx с ожидаемым объектом.

Что обычно идёт не так

• Восприятие 403 как плохого ключа и перевыпуск, который ничего не меняет.
• Повтор 429 в плотном цикле.
• Отправка поддержке ключа вместо requestId.