问题排查

所有请求都返回认证失败

检查：

是否使用了当前环境创建的 API Key；
请求头是否精确为 X-API-Key，且只出现一次；
Key 是否包含多余引号、换行或其他字符；
Key 是否已停用、吊销或过期。

认证失败不会返回具体原因。无法确认时，请在网页控制台创建新的 Key 并替换配置。

HTTP 200 但业务没有成功

这是正常的响应约定。请读取响应体 code；只有 code = 0 表示成功。根据错误码处理非零结果。

返回非 200、非 JSON 或空响应

这通常表示请求或响应在传输途中发生故障，例如 DNS、TLS、连接中断，或 CDN、网关、WAF、网络代理返回了其他内容。不要把这类结果记为业务成功。

保存响应中可获得的 X-TRACE-ID；没有追踪编号时，保存请求时间、请求路径和调用方自己的请求记录。读取操作可在网络恢复后重新查询。写操作不能根据传输失败断定“未生效”：带 request_no 的创建操作不得使用原请求号或新请求号盲目重提，应先按请求号与重复提交核对；其他写操作先查询当前状态。

创建请求结果不确定

遇到超时、断连、非 JSON 或空响应时，不要用原 request_no 或新 request_no 盲目重提。request_no 只用于防止重复受理，不是结果查询键，也不会重放第一次结果。

先通过已有的订单、账号、余额、批次或资源状态接口核对。仍无法唯一确认时，联系客户支持，并提供 request_no、调用时间、环境和 X-TRACE-ID（如有）；绝不能提供 API Key。详见请求号与重复提交。

静态订单一直处理中

继续按 10～30 秒间隔查询订单详情。不要高频连续查询。若持续时间超出业务预期，请准备以下信息联系支持人员：

环境；
接口路径；
order_no；
请求时间；
响应头 X-TRACE-ID；
响应体 code。

不要提供 API Key、代理密码或完整连接凭据。

没有收到回调

回调失败不会重试。请确认接收地址能够从公网访问、HTTPS 证书有效、不会返回重定向，并主动查询订单详情。回调只用于提醒，查询结果才是依据。

参数看似正确但返回 400009

重点检查：

是否发送了未列出的 JSON 字段或 Query 参数；
同一 Query 参数是否出现多次；
字符串、整数、布尔值的 JSON 类型是否正确；
枚举大小写是否正确；
时间是否带 Z 或显式偏移；
流量是否以普通十进制字符串发送。