错误码

开放平台全量错误码，按鉴权 / 参数 / 业务 / 系统 / Webhook 分组，含含义与处理建议。

所有接口统一返回以下结构，业务成功 code 为字符串 "0"，其余为错误码：

{ "code": "42201", "message": "字段校验失败：forecast_price 必须大于 0", "data": null }

HTTP 状态码与业务错误码配合使用：4xx 表示客户端错误，5xx 表示服务端错误。

鉴权类（400xx）

错误码	含义	处理建议
`40003`	ApiKey 无效/失效	确认 ApiKey 正确、未过期/撤销，且与所用环境（沙箱/生产）匹配
`40101`	缺少 ApiKey	检查是否携带 `X-Api-Key` 请求头，详见鉴权说明
`40301`	权限不足	确认该 ApiKey 已开通对应接口权限

错误码	含义	处理建议
`40401`	预报单不存在	确认 `forecastNo` / `poNumber` 正确
`40901`	PO Number 重复	同一 `poNumber` 不可重复提交
`40902`	当前状态不允许操作	如预报单已收货不可再修改
`40903`	物流单号重复	确认 `trackingNumber` 未被其他预报单占用

错误码	含义	处理建议
`42901`	触发限流	按 `Retry-After` 头退避，指数退避重试

错误码	含义	处理建议
`40801`	客户端响应超时	检查接收端点性能，5s 内返回 2xx
`40802`	客户端返回非 2xx	处理成功后返回 2xx，否则触发重试