请求的限制
对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坏请求
有一个解释性的信息。