REST API · ошибки
Коды ошибок API
Ответ об ошибке — application/problem+json (RFC 9457) с полями type, title, status, code, detail и request_id. Адрес в поле type ведёт на эту страницу, к нужной строке. Указывайте request_id, когда пишете в поддержку.
| HTTP | Код | Что значит | Что делать |
|---|---|---|---|
| 400 | validation_error | неверные параметры; в ответе поле `errors` со списком | исправить запрос |
| 400 | invalid_url | адрес не разобран или схема не http/https | исправить адрес |
| 400 | key_in_url | ключ передан в адресе | перевыпустить ключ, передавать в заголовке |
| 401 | unauthorized | нет ключа, ключ неверный или отозван | проверить ключ |
| 402 | insufficient_credits | нет кредитов | пополнить баланс |
| 403 | forbidden_scope | у ключа нет нужного права | выпустить ключ с правом |
| 403 | ip_not_allowed | запрос с IP вне списка ключа | добавить IP в настройках ключа |
| 404 | not_found | объекта нет или он принадлежит другому аккаунту | проверить идентификатор |
| 409 | idempotency_conflict | тот же `Idempotency-Key` с другим телом | новый ключ идемпотентности |
| 409 | scan_not_ready | отчёт ещё не готов | дождаться `done` или `partial` |
| 422 | url_forbidden | адрес ведёт во внутреннюю сеть, на IP-адрес или нестандартный порт | проверять только публичные сайты по доменному имени |
| 422 | domain_opted_out | владелец сайта отказался от автоматических проверок | — |
| 429 | rate_limited | превышен лимит | повторить после `Retry-After` |
| 500 | internal_error | ошибка сервиса | повторить позже; сообщить `request_id` в поддержку |
| 503 | service_busy | очередь перегружена | повторить после `Retry-After` |