错误码

目录
  1. 返回格式
  2. 错误码
  3. 重试建议

返回格式

所有接口都返回 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 秒……)。