Ошибки
При ошибке ok: false, HTTP-код соответствует ошибке, а в error.code — машинный код. error.message — пояснение по-русски, его можно писать в журнал, но не стоит показывать посетителю как есть.
{ "ok": false, "error": { "code": "ip_not_allowed", "message": "IP 198.51.100.4 не входит в список адресов сервера сайта" } }| HTTP | code | Когда | Что делать |
|---|---|---|---|
| 400 | bad_request | неверный параметр, нет X-Visitor-Ip | исправить запрос; лимит не тратится |
| 401 | unauthorized | нет ключа, ключ неверный, отозван или заблокирован | проверить ключ в кабинете |
| 402 | no_subscription | нет активной подписки на базу | оплатить или продлить подписку |
| 403 | ip_not_allowed | запрос не с IP сервера сайта | указать IP в настройках сайта |
| 404 | not_found | нет такого метода, базы или лота | лот мог уйти с торгов — убрать со страницы |
| 428 | captcha_required | посетитель превысил лимит запросов | показать посетителю капчу |
| 429 | limit_exceeded | исчерпан суточный лимит ключа или лимит посетителя после капчи | подождать: см. заголовок Retry-After |
| 429 | coverage_exceeded | за сутки запрошено слишком много разных карточек | до полуночи МСК новые карточки не открываются |
| 500 | internal | сбой на нашей стороне или база обновляется | повторить через минуту, показать кэш |
Ответ 428 дополнительно содержит error.captcha с адресами виджета и методов капчи.
Рекомендации
- Таймаут запроса — 10 секунд. При сетевой ошибке или 500 показывайте посетителю сохранённую копию страницы.
- Не повторяйте запрос сразу при 429 — это тоже расходует лимит посетителя.
- Пишите
error.codeв журнал — по нему проще найти причину.