CFCA开放平台

文档中心

接口列表

网络身份认证平台

企业认证

银行卡

移动运营商

身份证

网络身份认证平台

查看产品

更新时间：2022-12-19

JX视频人脸识别认证（静默活体）

接口描述

视频活体+身份证三要素认证(与公安留底照片比对)

请求方式

POST

生产地址

https://open.cfca.com.cn:9444/updopapi/cfca/identityVerify/V1/videoVerify/V1

测试地址

https://opentest.cfca.com.cn:9444/updopapi/cfca/identityVerify/V1/videoVerify/V1

公共请求参数

中文名称	英文名称	域类型	域长度	请求要求	备注
渠道号	X-Channel	string	32	O-选填	请求报文头填写，用于指定使用的渠道
实际渠道号	X-realChannel	string	32	R-需要返回	请求报文头为空，保存应答报文头实际渠道号
计费标识	X-feeFlag	string	4	R-需要返回	请求报文头为空，保存应答报文头收费标识
用户对账流水号	X-checkNo	string	32	O-选填	请求报文头填写，不建议使用
开放平台流水号	X-OpenCfcaNo	string	32	R-需要返回	请求报文头为空，保存应答报文头开放平台流水号
请求时间	X-OPEN-TS	string	20	M-必填	报文头字段。
数据签名	X-OPEN-SIGN	string	512	M-必填	（1）采用P7分离式签名，由CFCA提供SDK进行报文签名和验签。（2）报文签名：a. 将请求报文体和请求报文头中X-OPEN-TS以&作为连接符拼接成body=[请求报文体]&X-OPEN-TS=[X-OPEN-TS]形式的待签名串；b.对待签名串使用SHA256做摘要（摘要结果转16进制小写字符串），并使用RSA私钥对摘要做签名操作；c. 对签名做Base64编码，将编码后的签名串放在请求报文头X-OPEN-SIGN中。
开放平台账户ID	X-OPEN-APP-ID	string	128	M-必填	报文头字段。
语言地区	Locale	string	5	O-选填	请求报文体输入。
发送报文时间	Timestamp	string	14	M-必填	请求报文体输入，格式：yyyyMMddHHmmss。
交易类型	txCode	string	5	M-必填	请求报文体输入。企业法人四要素核验：02003；身份证三要素信息核验（不带发证地区代码，带照片）：04002；移动运营商校验：06004

请求报文体参数

中文名称	英文名称	域类型	域长度	请求要求	备注
备注	Remark	string	100	O-选填
证件类型编码	IdentificationTypeCode	string	2	M-必填
证件号码	IdentificationNo	string	80	M-必填
视频base64编码串	StrVideo	string		M-必填	视频base64编码串1、视频最短时长应大于2s，建议录制3s-5s的视频文件2、视频中应至少保证有一段超过2s的连续有同一完整人脸的片段3、最多只针对视频前5s进行检测4、支持格式:.mp4, .avi, .flv, .wmv, .mov, .rm。视频大小不应超过2M, 格式建议mp4
姓名	SubscriberName	string	450	M-必填	证件类型编码：身份证：0

同步应答参数

中文名称	英文名称	域类型	域长度	请求要求	备注
错误分类标识	ErrorClassification	string	32	O-选填	错误分类标识:00 认证通过（收费）01 认证未通过（收费）05 其他（不收费）
置信度	Confidence	string		M-必填	置信度。值为0-1，值越大表示本人的可能性越大，值低于0.70会返回系统判断为不同人,高于或等于0.7返回验证通过。
验证结果描述	StatusMessage	string	200	O-选填
验证结果	Status	string	2	O-选填	验证结果:0 验证通过2 身份证号码存在但姓名不匹配4 系统判断为不同人6 库中无照片7 检测人脸失败3 库中无此号，请核实99 其他错误
业务流水号	BusinessLogId	string	30	M-必填	业务流水号，为方便后续分析问题，请业务系统进行记录
结果信息	ResultMessage	string	200	M-必填	结果信息成功为“成功” 失败为错误信息
结果代码	ResultCode	string	8	M-必填	结果代码成功为“00000000”其他为失败

示例代码

暂无代码

提示信息

提示