错误码
返回格式
所有接口都返回 JSON,外层同一个样子:
{
"code": 200,
"msg": "",
"data": {},
"logId": "req_..."
}
| 字段 | 说明 |
|---|---|
| code | 跟 HTTP 状态码一样,200 是成功 |
| msg | 出错时说明原因;成功时是空字符串 |
| data | 结果;出错时一般是 null |
| logId | 这一次请求的编号,找我们排查问题时请带上 |
错误码
| code | 什么意思 | 扣不扣费 | 怎么办 |
|---|---|---|---|
| 400 | 请求不对:请求体不是合法 JSON、必填参数是空的、查询里只有搜索语法没有搜索词、网址太长 | 不扣 | 照 msg 改请求 |
| 401 | API Key 无效或已停用 | 不扣 | 到控制台核对 API Key,见 认证 |
| 402 | 余额不足 | 不扣 | 到控制台充值 |
| 422 | 读取网页没成功:网页打不开、站点不允许抓取、没有抽到正文 | 不扣 | 看 msg 和 data.step,见 读取网页 |
| 500 | 我们这边出错(读取单价、计费等) | 不扣 | 稍后重试;一直这样请带着 logId 联系我们 |
| 502 | 搜索或读取服务暂时不可用 | 不扣 | 稍后重试 |
只有成功(code 200)才扣费。 计费失败时接口回 500,不会把结果给出去,也不会扣钱。
重试建议
- 400、401、402、422:重试也是同样的结果,先改请求或充值。
- 500、502:隔几秒再试,最多试几次;用指数退避(1 秒、2 秒、4 秒……)。