活体人脸核身
POST
http://host:port/rest/faceid/livenessrecognition
接口描述
传入视频和身份信息，先判断视频中是否为真人，判断为真人后，再判断该视频中的人与公安权威库的证件照是否属于同一个人。 默认接口请求频率限制：20次/秒。
Header
参数名
类型
描述
必填
Authorization
string
通过API Key和Secret Key获取的access_token,参考“Access Token获取” （本地版不需传输）
必填
Content-Type
string
application/json
必填
请求参数
参数名
类型
描述
必填
id_card
string
身份证号码
必填
name
string
姓名（注：需要是UTF-8编码的中文）
必填
validate_session_id
string
活体检测随机码会话ID，需先调用接口获取随机码session_id； （当此字段为空时，为静默视频活体检测）。
可选
video_base64
string
用于活体检测的视频，视频的BASE64值； BASE64编码后的大小不超过8M，支持mp4、avi、flv格式。
必填
optional
string
额外配置，传入JSON字符串。 { "BestFrameNum": 2 //需要返回多张最佳截图，取值范围1-10 }
可选
comcode
string
保险公司内部机构、部门代码，为后续提供数据分析服务所用
可选
响应参数
参数名
类型
描述
必填
bestframe_base64
string
验证通过后的视频最佳截图照片，照片为BASE64编码后的值，jpg格式。 注意：此字段可能返回 null，表示取不到有效值。
可选
sim
float
与公安小图相似度可能性，用于验证生活照与公安小图是否为同一人，取值范围 [0.00, 100.00]。推荐相似度大于等于70时可判断为同一人，可根据具体场景自行调整阈值（阈值70的误通过率为千分之一，阈值80的误通过率是万分之一），推荐阈值80，超过即判断为同一人
必填
result
string
业务错误码，成功情况返回success或null, 错误情况请参考下方错误码 列表中FailedOperation部分
必填
description
sting
业务结果描述。
必填
bestframe_list
string
最佳截图列表，仅在配置了返回多张最佳截图时返回。 注意：此字段可能返回 null，表示取不到有效值。
可选