К содержанию
Libermall для разработчиков

Ошибки и лимиты

Ошибка всегда приходит 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 — делайте паузу и повторяйте.