错误码说明

业务错误优先看 codemsg,再结合 HTTP 状态码排查。

0
成功
40001
缺少必填参数
40002
参数类型或格式错误
40003
参数超出允许范围
40100
未授权 / Token 无效(若启用)
40300
无权限访问该资源
40400
资源不存在
42900
请求过于频繁,请稍后重试
50000
服务内部错误
50001
上游依赖服务异常

错误返回示例

{
  "code": 40001,
  "msg": "缺少必填参数: text",
  "data": null
}

排查清单

  • 先看 msg:多数参数问题可直接从提示定位字段名。
  • 核对编码:中文参数请确保 URL Encode / UTF-8。
  • 确认方法:GET/POST 是否与文档一致。
  • 控制重试:对 429/5xx 使用指数退避,避免雪崩。