小程序人脸认证

接口说明

[!NOTE]
君子签提供单独的小程序人脸识别服务,该接口主要用于小程序里做人脸识别。该接口涉及到人脸识别费用,如果未购买需要联系商务进行购买。

1、打开另一个小程序,请参考《微信官方文档》,地址:https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html

2、小程序人脸识别时效性为30分钟,超过30分钟后需重新调接口获取人脸相关参数。

3、打开另一个小程序中appId、path等相关参数请联系君子签对接客服获取。

4、打开另一个小程序中的extraData参数,需要传入小程序人脸认证接口返回的faceOrderNo、faceId、backPath(平台自定义地址:人脸完成后跳转的页面地址,可不传,不传回到跳转之前的页面)。

5、打开另一个小程序示例代码如下图:

6、小程序人脸认证对接流程图如下:

http请求方式

[!NOTE]
POST application/x-www-form-urlencoded

http请求地址

[!NOTE]
$SERVICE_URL/v2/auth/startMiniAppFace #其中$SERVICE_URL为生产或测试的地址

http请求参数

除公共必填参数外,还需要传以下参数

参数 类型 是否必填 默认值 说明
orderNo string * 订单号,最大支持32个字符
name string * 姓名
identityCard string * 身份证号
backUrl string * 同步回调地址
motions string * MOUTH 动作序列,BLINK(眨眼),MOUTH(张嘴),NOD(点头),YAW(摇头).多个动作用空格隔开,如"BLINK NOD" 注:最大仅支持2个动作。
complexity string ? 2 人脸难易度 , 1简单模式(不推荐使用), 2正常模式, 3困难模式,默认不传,使用2正常模式

代码实现

JAVA实现
  Map<String,Object> params=bodyParams;
        String url=SERVICE_URL+"/v2/auth/startMiniAppFace";
        params.put("orderNo","6ytpU6kkk756");//订单号(平台自定义),最大支持32个字符
        params.put("name","唐XXX");//姓名
        params.put("identityCard","500225198XXXXXXXX");//身份证号
        params.put("backUrl","http://www.XXXXXXXX");//同步回调地址
        params.put("motions","BLINK");//MOUTH 动作序列,BLINK(眨眼),MOUTH(张嘴),NOD(点头),YAW(摇头).多个动作用空格隔开,如"BLINK NOD"
        String str= HttpClientUtils.init().getPost(url,null,params,true);
        System.out.println(str);

http返回参数

[!NOTE]
返回response为application/json的数据,其字段说明如下

参数 类型 是否必返回 说明
success bool * 成功true;异常false
msg string ? 异常时,返回异常原因
resultCode string ? 异常时返回
data object ? 业务信息,接口响应成功时返回

[!NOTE]
data为JSON对象,参考:

参数 类型 是否必返回 说明
faceOrderNo string * 人脸订单号由服务器生成,和用户传入的订单号不一样
h5faceId string * 拉起小程序需要的参数人脸参数
userOrderNo string * 用户参数传入的订单号

[!NOTE]
返回结果,参考:

//正确响应:
{"data":{"faceOrderNo":"F1946FFE5A0544C0A4F784E45FFF15B2","h5faceId":"B73AA5C326FE41DAAF90A8A8DBD83B89","userOrderNo":"XXXXXXXXXXX"},"success":true}
//错误响应:
{"msg":"3-姓名或身份证不合法","resultCode":"BUSINESS_ERROR","success":false}

results matching ""

    No results matching ""