一、接口名称：

活体检测接口

二、接口介绍：

活体检测API是通过传入动作视频（张嘴、摇头等），判断是否为真人，检测成功会返回一张人脸照片用于下一步比对验证，该接口通常与人证比对接口配合使用。本接口支持API和H5方式接入，一般广泛用于用户实名注册场景，判断是否为本人操作，防止撸羊毛等网络欺诈行为，通常与人脸身份证比对接口配合使用（支持API、H5和SDK方式，本文档提供API和H5的接入方式）。

三、API接口文档

1、请求地址

https://api.shumaidata.com/v2/life/check

请求方式：POST

参数

2、签名算法说明：

商户分配的appid、当前时间毫秒数timestamp、商户分配的app_security， 三者通过&符号拼接成字符串进行md5得到

如： appid = xyzxyzxyz, timestamp = 1555378976238,app_security = efcefcefcefcef

拼接后的字符串：str = xyzxyzxyz&1555378976238&efcefcefcefcefc

加密后得到：sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d

3、正确返回：

{

   "msg": "成功",

   "success": true,

   "code": 200,

   "data":{

       "order_no": "588410148050046976",

       "motions":{

           "score": 0.9999746084213257,

      "motion": "BLINK",

      "passed": true

   },

   "passed": true,

   "feature_image_id": "efdc743eda7744ce9be4080654deb4c1",

   "hack_score": 0.7475364208221436

   }

}

4、错误返回：

{

   "msg": "入参错误,

   "success": false,

   "code": 400,

   "data": {}

}

5、各个模式对应的阈值

提示：

allow_tracking_miss=true，允许活体检测中的某一针，检测不到人脸

allow_tracking_miss=false，不允许活体检测过程中人脸丢失

注意：摇头这个动作， 动作幅度不能过大，动作不能太快，否则会检测不到人脸继而失败

6、返回字段说明

7、motions字段解释

8、获取行为特征照片

请求地址：https://api.shumaidata.com/v2/life/check/image?imageId=行为特征图片id

请求方式：get

注：照片只保存1小时，需要的话请及时保存

》》》》》延伸接口推荐：人脸身份证比对接口