Ограничения для запросов
Для запросов через API партнерской сети Маркета действуют различные ограничения.
Глобальные ограничения
На общее количество запросов через API действует два ограничения. С одним и тем же авторизационным ключом можно отправлять:
-
Не более 5 запросов в секунду. Актуальная информация об этом ограничении возвращается в HTTP‑заголовках ответа на каждый запрос:
Заголовок
Значение
X-RateLimit-Global-LimitЧисловое значение ограничения.
X-RateLimit-Global-RemainingКоличество запросов, оставшееся до превышения ограничения.
X-RateLimit-Global-UntilДата, до которой действует ограничение, в формате RFC 822 (например,
Thu, 10 Jul 2018 00:42:42 GMT). -
Не более 400 000 запросов в сутки. Актуальная информация об этом ограничении возвращается в HTTP‑заголовках ответа на каждый запрос:
Заголовок
Значение
X-RateLimit-Daily-LimitЧисловое значение ограничения.
X-RateLimit-Daily-RemainingКоличество запросов, оставшееся до превышения ограничения.
X-RateLimit-Daily-UntilДата, до которой действует ограничение, в формате RFC 822 (например,
Thu, 10 Jul 2018 00:42:42 GMT).
При превышении ограничения сервер возвращает HTTP‑статус ответа 403 и сообщение об ошибке.
Ресурсные ограничения
Общее количество запросов через API не должно превышать 5 запросов в секунду.
На запросы к некоторым ресурсам могут действовать отдельные ограничения:
- На количество запросов к ресурсу.
- На объем запрашиваемых данных в запросах к ресурсу.
Актуальная информация о ресурсном ограничении возвращается в HTTP‑заголовках ответа на каждый запрос к этому ресурсу:
|
Заголовок |
Значение |
|
|
Числовое значение ограничения. |
|
|
Количество запросов или объема данных в запросах к данному ресурсу, оставшееся до превышения ограничения. |
|
|
Дата, до которой действует ограничение, в формате RFC 822 (например, |
При превышении ограничений сервер возвращает HTTP‑статус ответа 403 и сообщение об ошибке.
Примечание
Если вы достигли ресурсного ограничения, каждый последующий запрос к этому ресурсу учитывается в рамках глобального ограничения.