01 — 快速开始
四步完成接入
从注册到首次调用成功，通常 10 分钟内可以完成
- 1
注册并完成认证
注册账号并完成企业认证，否则无法调用需实名的接口
- 2
获取 appKey
在控制台创建应用，系统分配 appKey 与 appSecret
- 3
组装签名并调用
按 sha256 规则生成 sign，随 header 一起提交
- 4
在线调试与上线
先用免费额度在线调试，验证通过后购买套餐上线
02 — 签名与鉴权
每个请求都要带签名
appKey、timestamp、sign 三个字段放在请求 header 中，body 参数按 x-www-form-urlencoded 提交
1. 取当前毫秒时间戳
timestamp
2. 拼接 appKey+timestamp+appSecret
按顺序直接拼接，不加分隔符
3. sha256 得到 sign
小写十六进制字符串
4. 提交请求
header 带 3 个签名字段
appKey = aaa;timestamp = 1682476980429;appSecret = bbb;sign = sha256(appKey + timestamp + appSecret)timestamp 与服务器时间偏差超过 5 分钟会返回签名错误（code 4），请先校准服务器时间
03 — 接口分类
按业务场景查阅接口
04 — 错误码
返回码含义速查
所有接口共用同一套返回码，统一在顶层 code 字段中返回
| code | 说明 | 排查建议 |
|---|---|---|
| 0 | 成功 | — |
| 1 | 参数错误 | 检查必填参数是否缺失、格式是否合法 |
| 2 | 无记录 | 权威库中未查到该条记录，属正常返回 |
| 3 | 第三方服务异常 | 上游通道波动，建议重试或联系技术支持 |
| 4 | 签名错误 | 核对 appSecret；检查时间戳是否偏差超过 5 分钟 |
| 5 | 余额不足 | 前往控制台充值或购买新的套餐包 |
| 6 | 调用频率超限 | 降低并发或联系商务提升 QPS 上限 |
| 7 | 账号停用 | 联系客服核实账号状态 |
| 8 | 接口已停用 | 该接口已下线，请改用替代接口 |
| 9 | 未开通接口权限 | 在控制台申请开通该接口，或联系客服协助 |
| 10 | IP 不在白名单 | 在控制台把调用方 IP 加入白名单 |
| 11 | 系统异常 | 服务端异常，请携带 seqNo 联系技术支持 |
| 12 | 实名状态错误 | 先完成企业实名认证再调用 |
| 99 | 其他异常 | 以 msg 返回的具体信息为准 |
05 — 常见问题
接入前后最常被问到的几件事
没找到答案？拨打 15267497702（同微信）由技术支持直接对接
免费试用额度怎么获取？需要先付费吗？
注册并完成企业实名认证后即可领取免费试用次数，无需预付。试用期内可调用全部已开通接口，测试数据与正式调用完全一致。
在官网购买了套餐，通过API调用应该选择哪个密钥呢？
在官网购买的套餐是用“扣套餐次数”密钥进行调用
购买了套餐之后，在哪里开发票？
在控制台 → 费用中心 → 我的发票，申请发票即可。发票开好后会短信通知您，一般 1-2 天可开好。
可以开专票吗？
专票、普票都可以开。
接口响应速度与稳定性如何保障？
平台已对接多条权威数据通道并做智能路由，平均响应时间低于 200ms，服务可用性 SLA 99.9%，通道异常时自动切换备用链路。
签名一直报 code 4，怎么排查？
先确认拼接顺序为 appKey + timestamp + appSecret，再检查服务器时间是否与标准时间偏差超过 5 分钟；两项都正常仍报错时，把完整请求参数发给技术支持定位。
调用量上去了，价格还能再谈吗？
平台按阶梯定价，调用量越大单价越低。超过十万次量级或有长期合作需求，可联系商务获取专属报价与结算方案。
支持哪些开发语言？有现成的示例代码吗？
接口为标准 HTTP 协议，任何语言均可接入。文档中心提供 Java、Python、PHP、C#、NodeJs、go、curl 七种语言的完整示例代码，复制即可运行。
还有问题？让技术支持直接对接你
API 免费试用 · 优质稳定通道 · 专属技术支持，7×24 小时响应
扫码在线咨询