Доступ

Ограничения

Что платформа ограничивает: частоту обращений, размеры тела запроса и объёмы выдачи.

Частота обращений

На рабочие эндпоинты — заказы, склад, товары, возвраты, производство — ограничений частоты нет. Ограничения стоят только на публичных действиях вроде входа и восстановления пароля, которых интеграция не касается.

Размеры и объёмы

  • Тело обычного запроса — до 100 КБ.
  • Тело запроса к производственному API — до 256 КБ.
  • Файл инвентаризации — до 10 МБ, формат xlsx или xls.
  • Список заказов — не больше 200 записей за раз.
  • История движений склада — не больше 200 записей за раз.
  • Список резервов — не больше 500 записей за раз.
  • Выгрузка заказов в Excel — не больше 5000 строк.
признак того, что данные кончились
// Страница короче запрошенного размера означает конец выборки
if (страница.length < limit) {
  // это была последняя порция
}

Что делать при отказе по частоте

Дождаться окна. В ответе приходят заголовки RateLimit-*: в них указано, сколько обращений осталось и когда счётчик обнулится. Повторять сразу бессмысленно — подробности в разделе про ошибки.