Ограничения для запросов

Для запросов через 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‑заголовках ответа на каждый запрос к этому ресурсу:

Заголовок

Значение

X-RateLimit-Method-Limit

Числовое значение ограничения.

X-RateLimit-Method-Remaining

Количество запросов или объема данных в запросах к данному ресурсу, оставшееся до превышения ограничения.

X-RateLimit-Method-Until

Дата, до которой действует ограничение, в формате RFC 822 (например, Thu, 10 Jul 2018 00:42:42 GMT).

При превышении ограничений сервер возвращает HTTP‑статус ответа 403 и сообщение об ошибке.

Примечание

Если вы достигли ресурсного ограничения, каждый последующий запрос к этому ресурсу учитывается в рамках глобального ограничения.