# 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+	支持
厂商内置浏览器	华为三星小米部分支持