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

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

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

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

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

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

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

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

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

  • X-RateLimit-Daily-Until — время обновления суточного ограничения для указанного в запросе авторизационного ключа, указывается в формате: Mon, 27 Feb 2017 00:42:42 GMT.

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

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

  • X-RateLimit-Global-Until — время обновления глобального посекундного ограничения для указанного в запросе авторизационного ключа, указывается в формате: Mon, 27 Feb 2017 00:42:42 GMT.

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

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

  • X-RateLimit-Method-Until — время обновления ресурсного посекундного ограничения для указанного в запросе авторизационного ключа, указывается в формате: Mon, 27 Feb 2017 00:42:42 GMT.

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

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