2324-移动H5人脸识别随机数唇语
1. 接口功能
根据姓名、身份证号和上传的视频，验证操作人真实性。上送身份信息之后会返回活体URL（可看示例报文中响应报文url字段），客户通过URL进入活体流程（分为随机数唇语识别和炫彩人脸识别，具体流程可见人脸视频流程）。之后数据平台会从客户完成的活体视频中随机截取一张图片，然后根据拿到的身份信息与图片到公安库中进行比对。最后返回验证结果。
调用方以页面form表单的形式提交请求参数，数据服务返回活体操作的URL（Token有效期是十分钟）。客户通过URL进入活体采集页面（采集页面由数据服务方提供），通过自拍有声视频（读4个随机数字）方式进行活体验证，支持用户拍摄的一段时长3s左右，大小在20M以内的视频。检测完成并提交上传视频后，数据平台会发送前台通知和后台通知（2319-活体验证验证结果通知）返回认证结果。
FrontUrl为用户完成或取消验证后网页跳转的目标URL。通知方式支持POST和GET，GET方式不包含请求参数，仅重定向到FrontUrl的页面。POST方式包含请求参数,解密报文后即可拿到活体认证结果。可参考常见问题中-示例程序ReceiveNoticePage.java
Backurl用户完成验证、取消验证、或验证超时后，请求接口调用方服务器的URL。通知内容与页面通知（POST方式）内容完全一致，为页面通知的补偿机制。可参考常见问题中-示例程序ReceiveNoticeBackground.java
注意：
1、机构方有网络限制需要添加数据平台IP:106.38.206.2、111.202.233.61、106.120.182.92添加白名单。
2、在生产环境中，通知地址需要使用HTTPS的通信方式。HTTP方式的通信属于不安全链路，存在安全风险。在生产环境中使用HTTP方式的，将无法得到服务可靠性保障。
3、FrontMethod为GET没有通知报文的解决方式：交易流水号TxSN拼接到FrontUrl中，接收到页面回调后，调用2315接口进行主动查询。
4、生产环境用户提交视频后，需要点击后续页面上出现的继续按钮，才能触发回调frontUrl前台通知。
5、注意：有些自带浏览器不支持录像，请参考”手机端浏览器兼容列表”。推荐使用QQ、chorme 等第三方浏览器。
6、机构方自有APP端调用H5若想使用炫彩人脸识别，需满足RTC兼容性要求及进行兼容性配置，配置指引见APP调用H5兼容配置指引。
2. 接口时序图
3. 报文结构
请求报文：
| 报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
|---|---|---|---|---|
| TxCode | R | NOT NULL | N1..4 | 交易类型 |
| InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
| TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
| Name | R | NOT NULL | ANS1..50 | 姓名 |
| ReturnImage | O | NOT NULL | ANS1..32 | 是否返照片，不出现时，默认不返照片 0 =不返 1 = 返照片 上送“0”或“1”即可 |
| IdentificationNumber | R | NOT NULL | N1 | 身份证件号码 |
| FrontUrl | R | NOT NULL | ANS1..512 | 前台通知地址 |
| BackUrl | R | NOT NULL | ANS1..512 | 后台通知地址 |
| FrontMethod | O | NOT NULL | ANS0..64 | 页面通知方式，默认POST 0 = POST 1 = GET 上送“0”或“1”即可 |
| Remark | O | N1 | 备注 | |
| Threshold | O | ANS2 | 档位，为空时，默认T5： T3 T4 T5 T6 |
响应报文：
| 报文元素 | 出现要求 | 非空约束 | 说明 |
|---|---|---|---|
| Code | R | NOT NULL | 响应代码 |
| Message | R | NOT NULL | 响应消息 |
| TxCode | C | NOT NULL | 交易类型 |
| InstitutionID | C | NOT NULL | 机构编号 |
| TxSN | C | NOT NULL | 交易流水号 |
| Url | C | NOT NULL | 活体操作链接 |
| TraceNo | C | NOT NULL | 交易跟踪号 |
4.报文样例：
[!TIP] （测试数据不校验数据真实性，默认为验证结果为匹配，若验证其他结果，可查看“总体规范-6.1.2.4 Remark 备注”）
请求报文(InstitutionID由中金分配)：
{
"FrontUrl":"https://172.31.4.66/DSPInstitutionSimulatorTest/ReceiveNoticePage",
"ReturnImage":"0",
"FrontMethod":"0",
"TxCode":"2324",
"IdentificationNumber":"430522199209122671",
"InstitutionID":"XXXXXX",
"TxSN":"202211281445394358743024303",
"BackUrl":"https://172.31.4.66/DSPInstitutionSimulatorTest/ReceiveNoticeBackground",
"Remark":"",
"Name":"王测试",
"Threshold":"T5"
}
响应报文：
{
"TxCode":"2324",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202211281445394358743024303",
"Code":"2000",
"Url":"https://dsptest.cpcn.com.cn/DSPLivenessWeb/InterfaceI?token=eyJhbGciOiJIUzUxMiJ9.eyJpbnN0aXR1dGlvbklEIjoiMDAwMDIwIiwidHhUaW1lIjoiMjAyMjExMjgxNDQ5MDMiLCJ0eFNOIjoiMjAyMjExMjgxNDQ1Mzk0MzU4NzQzMDI0MzAzIiwidHhDb2RlIjoiMjMyNCJ9.J6W_wMmAncqQscUpmby0wbVi0DpH64_0sVVuXaKPMxHr_a2VsD-NXDMO76dA5V6chBh8lAy7HoGMAb4AteZpfQ",
"TraceNo":"2211281449034801112018076"
}
该文档未解决您的疑问？
查看常见问题