# IVYZRXDB 错误代码
HTTP请求返回后，请读取业务响应中的`code`。`code=0`表示业务成功，成功响应的`data`按现有加密规范解密后可读取人像相似度`score`（0～1）。
| code | message / 含义 | 说明 |
| --- | --- | --- |
| 0 | 业务成功 | 已完成照片上传及人像比对，按主接口原有规则计费 |
| 1000 | 查询为空 | 比对阶段查空，沿用主接口原有查空计费规则 |
| 1001 | 接口异常 | 上传或比对过程中发生上游、网络、超时或响应格式异常 |
| 1002 | 解密失败 | 请求`data`无法按账号密钥和现有加密规范解密或解析 |
| 1003 | 参数校验不正确 | 缺少必填项、姓名或身份证号格式错误、Base64编码错误、图片格式不支持，或原始图片超过1MB |
| 1004 | 未经授权的IP | 请求IP未通过白名单校验 |
| 1005 | 缺少Access-Id | 未提供`Access-Id`请求头 |
| 1006 | 未经授权的AccessId | `Access-Id`无效或未授权 |
| 1007 | 余额或账号状态异常 | 钱包余额不足、账号冻结或受限等，具体以返回的`message`为准 |
| 1008 | 产品或订阅不可用 | 产品未开通、已停用，或订阅不存在、过期、暂停等 |
| 2001 | 业务失败 | 具体以返回的`message`为准 |
## 图片超限
`photo_data`仅支持JPG/JPEG、BMP、PNG的标准Base64编码，不含`data:image/...;base64,`前缀。**Base64解码后的图片最大1,048,576字节（1MB）**，建议不超过50KB。请先压缩原始照片，再进行Base64编码。
图片超过1MB时，实际响应为：
```json
{
"code": 1003,
"message": "参数校验不正确",
"transaction_id": "本次请求流水号"
}
```
`1003`的`message`为统一参数错误提示，不直接区分超限或其他格式问题。图片超限在本地校验阶段结束，不调用数据宝、不扣费。
## 上传失败与计费
上传失败立即结束请求，不继续比对、不扣费。上传阶段的数据宝错误码使用天远错误映射，例如上传返回的`10001`不会当作比对查空计费。
只有通过参数校验且上传成功后，才进入人像比对阶段。成功和比对查空沿用原计费规则，内部上传不单独扣费。
控制台调试外层`success: true`只表示调试请求返回，应继续检查业务响应的`code`；外层`success: true`且`data.code=1003`表示业务参数校验失败。
