状态码与错误处理

鲸海数据接口会通过业务状态码标识请求结果。不同上游接口可能使用 errcode、status 或 code,客户端建议统一兼容。

成功响应

{
  "status": 200,
  "message": "Success",
  "data": {},
  "success": true
}

判断逻辑建议:

function isSuccess(resp) {
    const code = resp.errcode ?? resp.status ?? resp.code;
    return code === 200 || resp.success === true;
}

状态码	含义	处理建议
`200`	成功	业务正常,读取 `data` 字段
`400`	请求参数错误	检查参数名、类型、必填项,尤其是企业名称、企业 ID、统一社会信用代码和分页参数
`401`	未登录或鉴权失败	重新登录;正式调用时检查凭证是否正确
`403`	权限不足	检查是否已实名、接口是否授权、免费额度/余额/次数是否充足、IP 是否在白名单
`404`	未查询到数据	企业信息不存在,或该企业暂无对应维度数据
`429`	请求频率超限	降低并发,指数退避后重试
`500`	服务暂时不可用	重试 1-2 次,持续失败请联系客服
`502`	上游接口连接失败	检查测试环境、网关、白名单或服务器出口网络
`504`	接口响应超时	稍后重试;如持续超时请提交 requestId 排查

{
  "errcode": 400,
  "errmsg": "参数错误",
  "data": null,
  "success": false
}

或:

{
  "status": 400,
  "message": "参数错误",
  "data": null,
  "success": false
}

如响应为 HTML、空响应或浏览器提示 fetch failed,通常意味着请求未到达业务接口,请优先检查网络、网关地址、白名单和测试环境可用性。