错误码
平台一律返回 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 | 时间戳超出允许范围 |
| 40103 | nonce 已被使用(重放请求) |
| 40300 | 无权限执行该操作 |
| 40301 | License 无效 |
| 40302 | License 已过期或超出宽限期 |
| 40303 | 超出授权路数 |
| 40304 | 算法包未授权 |
| 40305 | 点位未授权 |
| 40306 | 激活码无效或已被使用 |
| 40307 | 激活码已过期 |
| 40308 | 节点已绑定其它租户 |
| 40309 | 沙箱应用仅支持只读与 dryRun 调用 |
| 40400 | 资源不存在 |
| 42901 | QPS 超限 |
| 42902 | 日调用配额已耗尽 |
| 50000 | 系统繁忙,请稍后重试 |
| 50001 | 推理节点不可用 |
| 50002 | 依赖服务不可用 |