data.result,data.requestId 用于请求追踪。
成功响应
错误码
调用方应同时检查 HTTP 状态码与响应体中的业务code,不要只根据 msg 文本判断结果。
HTTP 状态与业务 code
HTTP 状态描述传输和服务处理结果;响应体中的code 描述业务调用结果。客户端需要依次校验这两层,任何一层失败都不应继续读取 data.result。
“有限重试”是推荐的客户端恢复策略,不代表平台承诺固定的重试次数或等待时间。当前重试上限应由调用方结合业务容错要求设置。
推荐处理顺序
1
检查网络与 HTTP 状态
先处理连接失败、超时、空响应和非 2xx HTTP 状态。
2
检查业务 code
HTTP 请求完成后,再判断响应体中的
code 是否为 200。3
记录 requestId
在成功响应中记录
data.requestId;发生异常时同时保留请求时间和 apiCode。4
按错误类型恢复
参数和凭证问题应修正后再请求;限流和平台异常可采用有限次数重试。
调用限制
查看超时、并发、有限重试和指数退避建议。
requestId 请求追踪
建立生产环境排错记录。
联调排错清单
按请求、认证、权限和响应解析逐项定位问题。