请求的限制

对Yandex请求的限制。卖家的市场API分为以下几种类型:

  • 全局限制(对同时请求数量的限制);

  • 资源限制(长时间内对同一资源的请求数量的限制,例如,每天);

  • 功能限制(对单个请求中要发送或返回的数据量的限制)。

全球限制

它们适用于来自单个登录的同时(并行)请求的数量。 允许同时运行不超过两个请求。

如果超过限制,服务器将返回一个特殊的HTTP代码。 420增强你的平静 带有解释性信息:

Hit rate limit of 2 parallel requests

资源限制

它们会影响一次登录后长时间内对同一API资源的请求量。 查询量是指请求的数量以及每个请求发送或返回的数据量。

对于大多数资源,这些限制仅适用于请求数。 这些限制对于每个资源都是单独的。

对于其他资源,限制适用于在对同一资源的请求中发送或返回的数据总量。 这些限制是为每个橱柜或商店单独计算的. 计算限制的标准在这些资源的描述中规定。 限制重新计算,延迟两到八个小时。

一些资源被分组为具有共同资源限制的组。 在这种情况下,限制适用于在很长一段时间内对组的任何资源的请求量。

在对请求的每个响应中,服务器都会返回特殊的HTTP标头,这些标头指示机柜或存储的资源限制状态:

  • 标题 X-RateLimit-Resource-Limit 包含限制的数值。

  • 标题 X-RateLimit-Resource-Until 包含限制适用的日期,格式为 RFC822 (例如, 星期四,2018年7月10日00:42:42格林尼治标准时间);

  • 标题 X-RateLimit-Resource-Remaining 包含超出限制之前剩余的对此资源的请求量的数值。

如果超过限制,服务器将发出一个特殊的HTTP代码。 420增强你的平静 例如,带有解释性消息:

Hit rate limit of 10 000 points per 1 day for resource /regions/{regionId}.json

功能限制

它们会影响每个请求为资源发送或返回的数据量。 每个资源的限制都是单独的,它们的值在方法本身的描述中指定。

此外,所有请求都有一个共同的限制:请求正文的最大大小为512KB。 如果卷较大,请将请求拆分为几个。

如果超过限制,服务器将发出一个特殊的HTTP代码。 400坏请求 有一个解释性的信息。