指南

错误码

平台一律返回 HTTP 200 + 业务码,第三方按码分支处理。

为什么不用 HTTP 状态码表达业务失败

平台用统一信封 {code, message, data}:HTTP 层只表达传输是否成功,业务失败全部体现在 code 上。这样第三方不需要在"网关超时、鉴权失败、业务拒绝"之间做猜测,也避免中间件改写 HTTP 状态导致语义丢失。

完整错误码表

下表由平台错误码枚举自动生成并写入 OpenAPI 规范(x-error-codes 扩展),新增码未同步文档会导致构建失败。

错误码含义
0成功
40000请求参数格式错误
40001参数非法
40010缺少 X-Tenant-Id 请求头
40011租户不存在或已停用
40012跨租户访问被拒绝
40100未认证或登录已过期
40101签名无效
40102时间戳超出允许范围
40103nonce 已被使用(重放请求)
40300无权限执行该操作
40301License 无效
40302License 已过期或超出宽限期
40303超出授权路数
40304算法包未授权
40305点位未授权
40306激活码无效或已被使用
40307激活码已过期
40308节点已绑定其它租户
40309沙箱应用仅支持只读与 dryRun 调用
40400资源不存在
42901QPS 超限
42902日调用配额已耗尽
50000系统繁忙,请稍后重试
50001推理节点不可用
50002依赖服务不可用