调用频率与配额
为保障平台稳定性,鲸海数据会对在线调试和正式接口调用分别设置额度、授权和频率控制。
在线调试额度
| 维度 | 当前规则 | 说明 |
|---|---|---|
| 使用前提 | 登录并完成实名认证 | 未实名账号不能调用在线调试 |
| 免费总量 | 1,000 次 | 账户级总量,不是每个接口单独赠送 |
| 计费方式 | 免费额度内不扣费 | 用完后需充值或后台开通接口 |
| 记录方式 | 自动记录调用日志 | 可用于排查接口、参数和响应 |
正式调用额度
正式接入后,后台会按客户订单配置接口授权。常见配置包括:
| 维度 | 说明 |
|---|---|
| 接口范围 | 可按单个接口或接口组合授权 |
| 单次价格 | 当前统一为 0.05 元/次 |
| 购买次数 | 按充值、套餐或商务合同配置 |
| 日调用上限 | 可按客户业务量配置,默认以后台授权为准 |
| 到期时间 | 套餐或合同到期后需要续费 |
| 计费模式 | 支持余额预付费,老客户可配置授信后付费 |
充值与套餐
当前充值中心支持提交余额充值和套餐订单。订单提交后,后台确认到账并开通额度。
| 类型 | 当前选项 |
|---|---|
| 余额充值 | 300 元、500 元、1,000 元、5,000 元,也可输入 1 元起自定义金额 |
| 套餐订单 | 1 万次 / 6 万次 / 10 万次 / 30 万次 |
| 套餐单价 | 均按 0.05 元/次展示 |
支付宝支付入口已在页面展示,实际到账和开通以后台订单确认为准。
触发限制时的响应
当账户未实名、未授权、余额不足、次数不足或请求过于频繁时,接口可能返回:
{
"errcode": 403,
"errmsg": "账户余额不足或接口未授权",
"data": null,
"success": false
}或:
{
"errcode": 429,
"errmsg": "Too Many Requests, please retry later",
"data": null,
"success": false
}客户端最佳实践
- 本地限流:在客户服务端控制并发,避免短时间集中请求。
- 指数退避:遇到
429、502、504时按2^n秒重试,最多重试 3-5 次。 - 缓存稳定数据:工商基础信息、商标等长期稳定数据建议本地缓存 12-24 小时。
- 记录请求日志:保留接口名、请求参数、状态码、耗时和 requestId,便于双方联调排查。
- 先在线调试再正式接入:确认字段和业务逻辑后再切换到生产调用。
更多错误码对照见 状态码与错误处理。