Руководство разработчика
Ресурсы API

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

Ограничения для ресурсов API Яндекс.Маркета делятся на два типа:

  • глобальные ограничения устанавливаются на количество запросов с одним и тем же авторизационным ключом в определенный промежуток времени (если авторизационный ключ выдан на несколько IP-адресов, то ограничения устанавливаются на количество запросов со всех IP-адресов этого ключа);

  • ресурсные ограничения устанавливаются на количество запросов к одному и тому же ресурсу с одним и тем же авторизационным ключом в определенный промежуток времени.

На данный момент глобальные ограничения определяются выбранным тарифом.

Оставшееся количество запросов до превышения глобального и ресурсного ограничения указывается в специальных HTTP-заголовках ответа на запрос:

  • X-RateLimit-Daily-Limit — возможное количество запросов с одним и тем же авторизационным ключом в сутки;

  • X-RateLimit-Daily-Remaining — оставшееся количество запросов для указанного в запросе авторизационного ключа в сутки до превышения суточного ограничения;

  • X-RateLimit-Daily-Until — время обновления суточного ограничения для указанного в запросе авторизационного ключа, указывается в формате: Wed, 20 Apr 2012 14:58:00 GMT;

  • X-RateLimit-Global-Limit — возможное количество запросов с одним и тем же авторизационным ключом в определенный промежуток времени (значение глобального ограничения);

  • X-RateLimit-Global-Remaining — оставшееся количество запросов для указанного в запросе авторизационного ключа в определенный промежуток времени до превышения глобального ограничения;

  • X-RateLimit-Global-Until — время обновления глобального посекундного ограничения для указанного в запросе авторизационного ключа, указывается в формате: Wed, 20 Apr 2012 14:58:00 GMT;

  • X-RateLimit-Method-Limit — возможное количество запросов к вызываемому ресурсу (значение ресурсного ограничения);

  • X-RateLimit-Method-Remaining — оставшееся количество запросов к вызываемому ресурсу до превышения ресурсного ограничения;

  • X-RateLimit-Method-Until — время обновления ресурсного посекундного ограничения для указанного в запросе авторизационного ключа, указывается в формате: Wed, 20 Apr 2012 14:58:00 GMT.

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

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