本指南介绍如何使用我们的 API 服务,鉴权、响应、速率限制和支持返馈资源。Authorization/鉴权#
要访问我们的 API,您必须在每个请求的请求头中添加您的API秘钥进行身份验证:要获取API密钥,请注册。现在注册,将赠送您一定的请求配额,供您免费试用!Response/响应#
所有 API 响应都返回 HTTP 状态代码 200 OK,无论业务结果如何。
您必须依赖 JSON 响应主体中的 code 字段来确定业务级结果。
| code | 说明 | 计费 |
|---|
| 200 | 成功 | YES |
| 0 | 失败 | NO |
| 401 | 未授权,APIKey无效 | NO |
| 403 | 账户不可用 | NO |
| 404 | API未找到或不可用 | NO |
| 301 | 余额不足 | NO |
虽然大多数 API 请求会在几秒钟内响应,但我们建议将请求超时设置为至少 60 秒。
这并不表示我们的 API 很慢——它只是有助于避免由于临时网络问题或客户端超时而导致的意外错误或重复收费。
虽然大多数 API 请求会在几秒钟内响应成功并返回数据,但也有部分不太稳定的接口,可以尝试多次请求(建议5次或5次以内,否则会触发风控,导致账户异常!),直到请求成功,请勿担心重复计费,只有成功的请求code=200才会计费。
部分接口存在多版本,V1、V2... 可以加入重试切换策略,在请求失败时切换另一个版本再次重试请求(注意:不同版本之间可能存在响应数据结构不一致的情况,请自行比对)。
Request rate/速率限制#
少数高流量端点可能有特定的速率限制(例如每分钟/小时),这将在各自的文档中注明。
Support&Feedback/支持与反馈#
如有任何疑问、定价详情、定制API,请随时通过我们的支持页面联系我们: