小程序人脸认证
接口说明
[!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 | * | 身份证号 |
代码实现
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");//身份证号
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}