错误码
通用约定：code=0 成功；业务响应的 HTTP 状态码恒为 200，以 code 判断业务结果（触发频率限制时例外，返回 429）。错误码按来源分三类，便于分类处理。
系统与参数
请求参数不合法或平台侧临时故障：检查入参、或稍后重试。
| 错误码 | 说明 |
|---|---|
1401 | 参数缺失或不合法 |
1429 | 请求过于频繁（负载限流，HTTP 429） |
1449 | 系统繁忙，请稍后再试 |
应用授权
签名 / 时间戳 / 防重放 / 应用状态 / 来源 IP / 账户余额准入问题：核对 appSecret 签名与鉴权、IP 白名单，余额不足需先预存信用点。
| 错误码 | 说明 |
|---|---|
2001 | 验签失败 |
2002 | 时间戳超窗 |
2003 | 重复请求 |
2004 | 应用不存在或已停用 |
2005 | 来源IP未授权 |
2006 | 信用点余额不足 |
业务对接
订单号 / 检测类型 / 文件 / 任务 / 报告等业务语义问题：按提示修正对接逻辑。
| 错误码 | 说明 |
|---|---|
2011 | 订单号重复 |
2012 | 不支持的检测类型 |
2013 | 文件缺失或不合法 |
2014 | 任务不存在 |
2015 | 报告尚未生成 |
2016 | 文件拉取失败 |
2017 | 检测类型未开通 |
2018 | 文件可读文本不足 500 字符（疑似扫描件/加密/损坏） |
调用频率限制
1429 表示触发了调用频率限制：单应用每分钟的调用次数有上限，超限返回 HTTP 429，响应头 Retry-After 给出建议等待秒数。这是保护性限制而非终态错误——按 Retry-After 退避后即可继续。具体额度、计数窗口与接入建议见 频率限制