Ошибки
Коды ответов и формат тела ошибки.
Ошибка всегда приходит в одном формате:
{
"error": {
"code": "validation_error",
"message": "Request validation failed.",
"details": { "issues": [] },
"requestId": "8f0c…"
}
}requestId дублируется в заголовке X-Request-Id. Присылайте его в
поддержку: по нему мы найдём запрос в логах.
| HTTP | code | Когда |
|---|---|---|
| 400 | bad_request | тело не парсится как JSON |
| 400 | validation_error | поля не прошли проверку, список в details.issues |
| 401 | unauthorized | ключа нет, он неверный, отозван или истёк |
| 402 | forbidden | тариф магазина не включает API |
| 403 | forbidden | у ключа нет нужного права |
| 404 | not_found | объекта нет в этом магазине |
| 429 | rate_limited | превышен лимит, ждите Retry-After секунд |
| 500 | internal_error | сбой на нашей стороне |
Лимиты
7 запросов в секунду на ключ. Каждый ответ несёт X-RateLimit-Limit,
X-RateLimit-Remaining и X-RateLimit-Reset (unix-время сброса).