状态与错误码
status |
含义 |
|---|---|
PENDING |
待处理,需求已保存并排队 |
PROCESSING |
处理中,尚未完成 |
COMPLETED |
已完成 |
只有 COMPLETED 表示业务完成。当前阶段尚未启动后续业务执行,新需求保留在 PENDING。
HTTP 状态与错误码
Section titled “HTTP 状态与错误码”| HTTP | code |
含义与处理 |
|---|---|---|
202 |
— | 提交已受理,保存 order_id |
200 |
— | 查询成功 |
400 |
INVALID_EXTERNAL_ORDER |
提交字段或类型错误,修正请求 |
400 |
INVALID_EXTERNAL_BM_ORDER |
绑定或解绑字段错误 |
404 |
AD_ACCOUNT_NOT_FOUND |
广告账户不存在 |
409 |
AD_ACCOUNT_AMBIGUOUS |
广告账户资料重复,需人工核对 |
400 |
INVALID_ORDER_QUERY |
查询参数不合法,只提供一种 ID |
403 |
EXTERNAL_ORDER_ACCESS_DENIED 或 WAF 拒绝页 |
检查出口 IP、HTTPS、路径和请求方法 |
404 |
EXTERNAL_ORDER_NOT_FOUND |
工单不存在,检查 ID |
409 |
ACCOUNT_DEMAND_ID_CONFLICT |
请求 ID 已存在,但提交内容不同 |
413 |
— | 请求体超过 32 KB |
415 |
JSON_REQUIRED |
提交请求未使用 application/json |
5xx |
— | 服务暂不可用或写入失败;保留原请求 ID 重试 |
JSON 格式损坏或请求体压缩也可能返回 400。Cloudflare 拦截返回的内容可能是 HTML,调用方应先判断 HTTP 状态,再决定是否解析 JSON。
错误响应示例
Section titled “错误响应示例”{ "code": "ACCOUNT_DEMAND_ID_CONFLICT", "message": "account_demand_id already exists with different data."}以 HTTP 状态和 code 判断结果,不依赖错误描述文本。不同错误的额外字段可能不同。