Документация для разработчика
Полная техническая документация с примерами запросов и ответов — на странице Документация API. Передайте ссылку вашему разработчику.
Лимиты запросов
| Метод | Лимит |
|---|---|
| Цены и остатки (компакт) | 120 запросов в минуту |
| Полные карточки | 30 запросов в минуту |
| Заказы | 60 запросов в минуту |
| Создание заказов | 10 запросов в минуту |
| Всего на токен | 20 000 запросов в сутки |
При превышении лимита сервер отвечает кодом 429 и указывает, через сколько секунд можно повторить (заголовок Retry-After).
Частые ошибки
| Код | Что значит | Что делать |
|---|---|---|
| 401 invalid_token | Токен не передан или не существует | Проверьте заголовок Authorization |
| 401 token_revoked / token_expired | Токен отозван или истёк | Создайте новый токен в личном кабинете |
| 403 api_disabled | Доступ к API выключен | Обратитесь к менеджеру или в клиентскую службу |
| 403 insufficient_scope | У токена нет нужного доступа | Создайте токен с нужными доступами |
| 422 validation_failed | Позиции заказа не прошли проверку | Смотрите детали по каждой позиции в ответе |
| 429 rate_limited | Превышен лимит запросов | Подождите и повторите |
Рекомендации по нагрузке
- Полный каталог (view=full) обновляйте раз в сутки, цены и остатки (view=offers) — раз в 15–60 минут
- Кэшируйте данные у себя, не запрашивайте одно и то же в цикле
- Обрабатывайте ответ 429: дождитесь секунд из Retry-After и повторите
- Листайте каталог через next_cursor, а не увеличением limit