Коды ошибок API и способы решения
Что делать при ответах 401, 403, 409, 429 и 503.
Время чтения: 3 мин
Ошибки API возвращаются с полями error, message, statusCode и requestId.
| Код | Возможная причина | Что делать |
|---|---|---|
401 | Ключ отсутствует, неверен, отозван или истёк | Проверьте заголовок; при необходимости выполните ротацию ключа. |
403 | У ключа нет необходимого scope | Создайте новый ключ с нужными scope. |
409 | Один и тот же Idempotency-Key использован с другим телом запроса | Генерируйте новый ключ для каждой новой операции. |
429 | Превышена квота тарифа или лимит запросов | Подождите время из Retry-After; проверьте потребление в консоли. |
503 | Временный сбой биллинга (операции записи) | Повторите запрос с тем же Idempotency-Key. |
Никогда не передавайте ключ в обращении в поддержку; вместо этого сообщите значение X-Request-Id из ответа. Подробности — в документации Ошибки и лимиты.
Было ли это руководство полезным?
Другие руководства по этой теме
Всё ещё не решили?
Если вы укажете название этого руководства, мы поможем быстрее.