2310-SDK人脸核身授权
1. 接口功能
首先根据数据平台提供的V5版本SDK操作手册将SDK集成到APP中，通过2310-SDK人脸核身授权接口获取BizToken（BizToken唯一且仅能使用一次，有效期为1小时）并初始化SDK活体页面进行活体采集验证，用户操作完成后SDK会告知状态给APP。第二步SDK收到用户活体完成通知后，上传核验人员姓名、证件号码和BizToken调用2311-SDK人脸核身V5验证接口获取活体验证结果。
2. 报文结构
请求报文：
| 报文元素 | 出现要求 | 数据类型 | 数据格式 | 说明 |
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| SystemFlag | O | N1..2 | 系统标识： 1-安卓 2-IOS 3-鸿蒙 |
|
| Remark | O | ANS0..256 | 备注 | |
| SdkVersion | O | ANS1..8 | Sdk版本： 空：非V5版本 V5：V5版本 |
|
响应报文：
| 报文元素 | 出现要求 | 数据类型 | 数据格式 | 说明 |
| Code | R | NOT NULL | N1..6 | 响应代码 |
| Message | R | NOT NULL | ANS1..256 | 响应消息 |
| TxCode | C | NOT NULL | ANS1..4 | 交易类型 |
| InstitutionID | C | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | C | NOT NULL | ANS1..32 | 交易流水号 |
| TraceNo | C | NOT NULL | ANS1..32 | 系统跟踪号 |
| C | NOT NULL | N0..4 | 通道响应代码 | |
| C | NOT NULL | ANS0..256 | 通道响应消息 | |
| Status | C | N2 | 状态： 20-获取成功 30-获取失败 |
|
| BizToken | C | ANS1..1024 | BizToken值 |
3.报文样例
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
请求报文(InstitutionID由中金分配)：
{
"TxCode":"2310",
"InstitutionID":"XXXXXX",
"SystemFlag":"3",
"SdkVersion":"",
"TxSN":"202408051116449949168400831",
"Remark":""
}
响应报文：
{
"Status":"20",
"ResponseCode":"1000",
"TxCode":"2310",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"BizToken":"1722827810,9d2fa1f7-0d92-4325-87b7-2fab1eef652c",
"TxSN":"202408051116449949168400831",
"ResponseMessage":"查询成功",
"Code":"2000",
"TraceNo":"2408051115359291110001723"
}
该文档未解决您的疑问？
查看常见问题