API 每分钟的速率受到限制,不同资源存在不同的限制,具体取决于客户账户。假设某资源的限速为每分钟 10 次请求;在同一分钟内(例如,从 16:20:00 到 16:21:00)请求超过 10 次将返回错误。限速程序允许集中式请求,例如,如果在前 50 秒没有收到任何请求,但接下来的 10 秒内收到 10 次请求,这些请求都将成功发送。
您必须在 API 客户端中对 HTTP 429 响应代码部署适当的错误处理。建议使用指数退避策略结合随机抖动来处理 HTTP 429 响应码。
不同的资源适用不同的限速规则,具体取决于 API 客户端是否发出经验证的请求,详细信息如下所列。
请求类型 | 请求路径 | 速率限制(真实环境) | 速率限制(演示环境) |
---|---|---|---|
验证 | /v2/authenticate/api |
每分钟 60 次请求 | 每分钟 60 次请求 |
请求速率 |
/v2/rates/find , /v2/rates/detailed
|
每分钟 200 次请求 | 每分钟 150 次请求 |
所有其他经验证的请求 | /v2/* |
每分钟 500 次请求 | 每分钟 150 次请求 |
所有其他未经验证的请求 | /v2/* |
每分钟 200 次请求 | 每分钟 200 次请求 |
超出速率限制
当超出速率限制时,API 将返回 HTTP 状态码 429 -- "Too Many Requests",并附带一个 JSON 格式的响应正文,示例如下:
HTTP/1.1 429 Too Many Requests Date:Mon, 25 Jan 2021 13:16:59 GMT Content-Type: application/json; charset=UTF-8 { "error_code": "too_many_requests", "error_messages": { "base": [ { "code": "too_many_requests", "message":"Too many requests have been made to the api.Please refer to the Developer Center for more information", "params": {} }, ] } }
您应在等待 60 秒后重试请求。
其他需求
如果您有其他需求,请联系我们的团队,我们将竭力满足您的需求。