活体检测SDK接口对接指南

2025-07-01

数脉API

活体检测SDK接口对接指南

 人脸活体检测SDK介绍

人脸活体检测SDK是确保当前识别到的人脸是否为真实活体,而不是照片、视频、面具或其他伪造品的一种集成到应用程序中的软件开发工具包。其核心原理在于通过多模态数据采集、深度学习算法、动态行为检测等技术,完成捕捉用户的生物特征动态,精准识别真假人脸的细微差异,通过实时分析动作连贯性和生理特征变化,判断目标是否为真实活体。

 

配合式活体检测SDK技术原理

要求用户按照提示,完成一定的动作,如眨眼、张嘴、摇头、点头等。通过配合式活体检测SDK,分析用户执行动作时的连贯性、自然性,是否符合指令要求,以及再动作过程中的面部文理纹理、光影、边缘等变化是否符合真人特征。

其防攻击效果好于静默式活体检测,但需用户配合进行动作,故用户体验稍差。

 

活体检测SDK核心应用场景

金融场景:活体检测常用于互联网金融行业的远程开户、信贷审批、转账支付等环节。

门禁考勤:在小区、办公场所等门禁和刷脸考勤中,通过活体检测SDK可以有效防止使用照片、视频等方式非法侵入。

政务民生:政务机关通过活体检测SDK实现线上业务办理时的身份核验。如办理公积金业务时,无需前往线下网点,经过活体检测的用户即可在线办理相关业务,极大提升了业务效率。

互联网平台:游戏、电商、社交等互联网平台,通过活体检测SDK防范虚假注册、账号盗用等行为。如游戏平台通过活体检测落实未成年人防沉迷政策;婚恋平台通过活体检测确保用户身份真实性,避免婚恋欺诈风险。

 

 

数脉API 配合式活体检测SDK对接



对接流程

1. 联系数脉API官方客服,获取SDK包

2. APP端根据接入文档集成SDK

3. 提供包名或BundleID给到客服添加白名单

4. 调用SDK结果查询接口获取照片

 

 

示例代码(java):

   private static final String appId = "数脉分配给你的appid";

    private static final String appSecurity = "数脉分配给你的appsecurity";

 

    public static void main(String[] args){

String timestamp = System.currentTimeMillis() + "";

        String packageName = "包名";

        String signData = "对sdk获取的liveImage字节数组进行Base64编码后的加密字符串";

        //接口地址

        String url = "https://api.shumaidata.com/v3/life-sdk/check";

 

        //MD5Utils文件请联系工作人员索取

        String sign = MD5Utils.encrypt(appId+"&"+timestamp+"&"+appSecurity);

        System.out.println("sign: "+sign);

 

        Map<String,String> headers = new HashMap<String,String>();

        headers.put("Content-Type","application/x-www-form-urlencoded");

 

        Map<String,Object> params = new HashMap<String,Object>();

        params.put("appid",appId);

        params.put("timestamp",timestamp);

        params.put("sign",sign);

        params.put("packageName", packageName);

        params.put("signData", signData);

 

        //HttpUtils文件请联系工作人员索取

        String result = HttpUtils.postForm(url,headers,params);

        System.out.println(result);

}

 

验证通过返回:

{

    "msg": "成功",

    "success": true,

    "code": 200,

    "data": {

        "orderNo": "643194240063456587",

        "result": 0,

        "size": "56487",

        "width": "465",

        "height": "632",

        "sceneImage": "/9j/4QT0RXhpZgAATU0AKgAAAAgABQEAAA",

        "faceImage": "/9j/4QT0RXhpZgAATU0AKgAAAAgABQEAAA",

        "desc": "活体检测通过"

    }

}

 

 

验证不通过返回:

{

    "msg": "成功",

    "success": true,

    "code": 200,

    "data": {

        "orderNo": "700883818443839856",

        "result": 1,

        "size": null,

        "width": null,

        "height": null,

        "sceneImage": null,

        "faceImage": null,

        "desc": "活体检测不通过"

    }

}

 

 

验证错误:

{

    "msg": "参数错误",

    "success": false,

    "code": 400,

    "data": { }

}

 

 

返回字段说明: