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.