Ошибки и ограничения
Полный список ошибок программного интерфейса с причинами и способами устранения, а также ограничение частоты запросов и правила повторных обращений.
Ограничение частоты
Не более 60 запросов в минуту с одного адреса. При превышении приходит код 429; в этом случае подождите и повторите — наращивая паузу, а не долбя в тот же интервал.
- Запрашивайте статусы пачками через orders, а не по одному заказу в запросе.
- Список услуг меняется примерно раз в час — кэшируйте его у себя, а не тяните перед каждым заказом.
- Не опрашивайте статус чаще, чем раз в несколько минут: чаще он всё равно не меняется.
Ошибки
| Сообщение | Причина | Что делать |
|---|---|---|
| Invalid API key | Ключ неверен, перевыпущен или не передан. | Проверьте параметр key и возьмите актуальный ключ в настройках. |
| Incorrect service ID | Идентификатор услуги не число или услуга отключена. | Обновите список через action=services: услуги пропадают, когда их закрывает поставщик. |
| Incorrect quantity | Количество не число либо выходит за пределы услуги. | Сверьте с полями min и max этой услуги. |
| Order not specified | Не передан номер заказа. | Добавьте order или orders. |
| Not enough balance | Недостаточно средств на счёте. | Пополните баланс. Частично заказ не оформляется. |
| Bad request (код 400) | Тело запроса не разобрано. | Проверьте заголовок Content-Type и кодировку параметров. |
| Too many requests (код 429) | Превышено ограничение частоты. | Сделайте паузу и повторите, увеличивая интервал. |