Skip to main content
AIBase 使用统一外层响应结构。业务结果位于 data.resultdata.requestId 用于请求追踪。

成功响应

错误码

调用方应同时检查 HTTP 状态码与响应体中的业务 code,不要只根据 msg 文本判断结果。
实际错误码及错误信息以平台返回结果为准。错误响应中的 data 可能为 null,解析时必须做好空值兼容。

HTTP 状态与业务 code

HTTP 状态描述传输和服务处理结果;响应体中的 code 描述业务调用结果。客户端需要依次校验这两层,任何一层失败都不应继续读取 data.result
“有限重试”是推荐的客户端恢复策略,不代表平台承诺固定的重试次数或等待时间。当前重试上限应由调用方结合业务容错要求设置。

推荐处理顺序

1

检查网络与 HTTP 状态

先处理连接失败、超时、空响应和非 2xx HTTP 状态。
2

检查业务 code

HTTP 请求完成后,再判断响应体中的 code 是否为 200
3

记录 requestId

在成功响应中记录 data.requestId;发生异常时同时保留请求时间和 apiCode
4

按错误类型恢复

参数和凭证问题应修正后再请求;限流和平台异常可采用有限次数重试。

调用限制

查看超时、并发、有限重试和指数退避建议。

requestId 请求追踪

建立生产环境排错记录。

联调排错清单

按请求、认证、权限和响应解析逐项定位问题。