3 身份证返照接口
使用说明: 身份证返照接口可使用于章节服务介绍中的身份证返照校验服务中,具体使用步骤请参考身份证返照校验服务的时序图。
注意事项: 本接口通过AES加密进行通信。
3.1 功能描述
此接口用于核实姓名身份证号是否匹配、是否真实有效。
3.2 接口路径
https://rra.tongfudun.com/func/id/verify
3.3 请求方式
POST(application/json)
3.4 提交参数(分为明文数据和明文加密后的数据)
构造的明文数据为:
| 参数 | 描述 | 备注 |
|---|---|---|
| name | 身份证姓名 | |
| cid | 身份证号码 |
构造的密文数据为:
| 参数 | 描述 | 备注 |
|---|---|---|
| data | 密文数据 |
3.5 返回参数(分为密文数据和密文解密后的数据)
返回的加密数据为:
| status | message | data |
|---|---|---|
| -100 | 加密数据,请解密后使用 | 密文 |
| 10031 | 签名校验失败 | |
| 10042 | 接口密钥通信失败,请联系管理员 | |
| 10044 | 加密异常,请联系管理员 |
-100状态下对应的密文解密后的数据
| status | message | data |
|---|---|---|
| 0 | 身份信息校验成功 | {"textTuredImage":"网纹照片的base64编码"} |
| -1 | 参数异常 | |
| 10011 | 服务异常,请联系通付盾管理员 | |
| 10032 | 该服务尚未开通 | |
| 10033 | 服务欠费,请充值 | |
| 1102 | 身份证号码与姓名一致,暂无网纹照片 | |
| 1101 | 身份证号码与姓名不一致 | |
| 1103 | 无此身份证号码,请到户籍所在地进行核查 | |
| 1104 | 查询超时 |
3.6 示例
请求参数示例
加密前的数据: { "name":"stream", "cid":"13xxxxxxxxxxxxxxxxx" } 加密后的数据: { "data":"密文" }返回结果示例
{ "status":"-100", "message":"加密数据,请解密后使用", "data":{}, "aesData":"密文" } 返回密文解密后的数据: { "status":"0", "message":"身份信息校验成功", "data":{"textTuredImage":"图片base64编码"} }