接入文档
RAW纯接口接入
接入指引
接入指引

# API接口概览

移动端H5身份验证服务(FaceID Lite) 产品提供了一个完整的业务验证流程,而对于通过微信小程序方式进行集成、或希望能够完全自定业务流程、或希望能够完全自定业务页面的用户,可以直接集成云端的活体验证能力并自行实现前端的用户交互页面部分。

FaceID Raw纯接口模式提供了四种云端活体验证的能力,分别是视频活体技术、双角度活体技术、静默活体和炫彩活体技术。以下分别是几种活体的相关信息和调用逻辑:

活体技术 功能说明 API的调用逻辑 前端交互设计参考
视频活体 通过朗读随机数字的方式来验证其为真人~~,并采集验证人人像信息。~~**注:**此种手段的安全性会比双角度高,但微信版本号小于6.5集成时须跳出到系统浏览器。 Raw-GetRandomNumber (获取随机数字)Raw-ValidateVideo (上传视频进行活体验证)Raw-Verify (人脸核身) 视频采集的长度3~6秒 视频大小不超过20MB 视频中避免多人脸情况 人脸清晰、完整、在手机屏幕中大小合适 合适的光照环境,避免逆光,阴影等情况 确保录音权限,确保视频中的声音大小合适
双角度活体 通过正脸和侧脸照片进行3D重建方式来验证其为真人~~,并采集验证人人像信息。~~**注:**此种手段的安全性会比视频活体低,但对于前端微信集成无须跳出到系统浏览器。 Raw-ValidateFrontFace (验证正脸自拍照)Raw-ValidateSideFace (验证侧脸自拍照)Raw-Verify (人脸核身) 自拍照片有人脸,避免模糊、过亮或过暗 自拍照片中避免多人脸情况 自拍照片中人脸在手机屏幕中大小合适 正面自拍照片的角度必须是正脸 侧面自拍照片的角度要求20°~30°之间 两张照片的采集时间间隔不要过长 要求上传原始的用户自拍照片,不要对图片进行额外的压缩等操作
静默活体 通过采集人脸视频(无需额外动作)来验证其为真人~~,并采集验证人像信息。~~**注:**此种手段安全性比视频活体略低,兼容性与视频活体相同。 Raw - ValidateStill(上传人脸视频)Raw - Verify(人脸核身) 视频采集长度以1-3秒为佳 视频大小不超过20MB 视频中避免多人脸情况 人脸清晰、完整、在手机屏幕中大小合适 合适的光照环境,避免逆光,阴影等情况
炫彩活体 通过屏幕打光,在脸部形成反光的方式来验证其为真人~~,并采集验证人像信息。~~注:此种手段安全性比静默活体高,兼容性见本文档下方手机浏览器支持列表 1、Raw-GetToken接口(获取token参数,作为调用js-sdk的入参)2、引入js-sdk,并调用3、验证通过,服务端获取Raw-GetResult结果 屏幕区域进行彩色打光的面积超过80% 打光过程中引导用户正对屏幕 视频中避免多人脸情况 兼容提示及方案(当浏览器不支持webrtc技术时,需要进行处理,引导至其他活体形式相关的提示) 人脸清晰、完整、在手机屏幕中大小合适 引导用户在正常光线情况下使用,避免光线过爆情况

注:活体技术能极大程度保障验证安全性,除此之外,在前端流程中可考虑加入身份证OCR和五分类的方式来进一步增强验证的安全性。若采用该方案,可以通过FaceID OCRIDCARD API配合前端H5页面进行。

# 手机浏览器支持列表

浏览器名称 支持情况
Chrome 支持
FireFox 支持
Opera 支持
Safari 支持( iOS11及以上)
QQ浏览器 支持
Android Browser 5.0+ 支持
厂商内置浏览器 华为三星小米部分支持
该文档未解决您的疑问?查看常见问题