Ошибки и лимиты
Ошибка всегда приходит JSON-объектом с человеческим текстом и, где можно, машинным кодом. Ориентируйтесь на
code, а не на текст — текст может меняться.
{ "error": "Not enough money on the wallet", "code": "insufficient_balance" }Коды ответов
| Код | Что случилось | Что делать |
|---|---|---|
400 | Запрос не прошёл проверку | Исправьте тело или заголовки — подсказка в error |
401 | Нет ключа или он неверный, отозван | Проверьте заголовок ключа |
402 | Не хватает денег на кошельке (Buyer API) | Пополните кошелёк, сколько не хватает — в missing_minor |
403 | У ключа нет нужного права | Выпустите ключ с этим правом — список прав |
404 | Нет такого объекта или он не ваш | Мы не различаем «нет» и «чужое» — так никто не узнает чужие id |
409 | Конфликт: повтор с другим телом, дубль, запрос ещё выполняется, цена изменилась | Смотрите code; при in_flight повторите позже |
429 | Слишком много запросов | Подождите столько секунд, сколько в заголовке Retry-After |
503 | Временно недоступно | Повторите чуть позже с тем же Idempotency-Key |
Коды Buyer API
| code | Значение |
|---|---|
idempotency_key_required | Не передан Idempotency-Key |
max_price_required | Не передан max_price_minor |
insufficient_balance | Не хватает денег на кошельке |
price_changed | Заказ дороже max_price_minor, сумма — в total_minor |
idempotency_conflict | Ключ повтора уже использован с другим телом |
in_flight | Первый запрос ещё выполняется |
duplicate_external_ref | Заказ с таким external_ref уже есть |
codes_unavailable | Коды временно недоступны — повторите |
rate_limited | Превышен лимит запросов |
Лимиты
Buyer API — 240 запросов в минуту на ключ. При превышении — 429 rate_limited и заголовок Retry-After. Seller API тоже ограничивает частоту и отвечает 429 — делайте паузу и повторяйте.