错误码
错误码分两层。外层 code 反映接口层处理结果，data.bizCode 反映业务处理结果。判断调用是否真正成功，需同时满足 code == 0 且 data.bizCode == 0。响应结构见 统一响应结构。
接口错误码（code）
| code | 说明 | 处理建议 |
|---|---|---|
| 0 | 成功 | — |
| 401 | 权限校验失败 | 按下表定位具体原因 |
| 429 | Too Many Requests | 降低调用频率后重试，各接口并发上限为 10 次 / 秒 |
401 的具体原因
| 返回信息 | 含义 | 处理建议 |
|---|---|---|
| Missing required headers | 缺少必需的请求头 | 检查 公共请求头 是否完整 |
| Invalid timestamp format | 时间戳格式不正确 | X-Timestamp 须为秒级时间戳 |
| Request timestamp expired | 请求时间戳已过期 | 校准服务器时间后重新发起 |
| Invalid nonce format | nonce 格式不符合约束 | 须满足 ^[A-Za-z0-9]{16,32}$ |
| Nonce already used or validation failed | nonce 已被使用或校验失败 | 每次请求使用新的随机串，不可复用 |
| appId not found | appId 不存在 | 核对 APP-ID |
| appId is disabled | appId 已被停用 | 联系技术支持 |
| Signature calculation failed | 签名计算失败 | 检查签名实现，见 签名机制 |
| Signature verification failed | 签名校验失败 | 核对待签名字符串的拼接顺序、path 是否含 /open-apis 前缀、timestamp 与 nonce 是否与 Header 一致 |
业务错误码（bizCode）
| bizCode | 中文说明 | 英文说明 |
|---|---|---|
| 0 | 成功 | Success |
| 10000001 | 参数异常 | Invalid parameters |
| 10000003 | 操作过于频繁，请稍候片刻再试 | Too many requests. Please wait and try again |
| 10000103 | 系统服务异常，请联系客服处理 | The system service is abnormal, please contact customer service |
| 100027001 | 积分操作参数不合法 | Invalid credit operation parameters |
| 100027003 | 积分余额不足 | Insufficient credit balance |
| 100041003 | 建模任务不存在 | Spatial modeling task does not exist |
| 100041004 | 建模结果不存在 | Spatial modeling result not found |
| 100041006 | 空间不存在 | Space not found |
| 100041010 | appId 无空间建模权限 | AppId does not have spatial modeling permission |
| 100041016 | 任务状态建模中，不允许删除 | Task status [modeling], deletion is not allowed |
| 100041017 | 任务当前状态不可取消 | Task cannot be canceled in its current status |
建模失败的排查
任务进入建模失败（9）时，通过 任务列表分页查询 或 任务信息详情查询 读取 errorCode 与 failedReason 定位原因。
这两个字段反映的是建模流程内部的失败信息，与上表的 bizCode 不是同一套取值。接口调用成功但任务建模失败时，bizCode 仍为 0。