主题
移动端刷脸服务 mapi.fwc.face.check FunctionCode | SER-B001
faceCertification
- 人脸核身
注意
- 对接微信人脸核身需要向微信公众号申请 requestWxFacePictureVerify 接口权限
- 需要初始化微信 JSSDK 微信开放平台
- 如果页面加载时调用, 需要在
wx.ready
事件中调用
微信jssdk初始化
js
wx.config({
appId: '', // 必填,公众号的唯一标识
timestamp: , // 必填,生成签名的时间戳
nonceStr: '', // 必填,生成签名的随机串
signature: '',// 必填,签名
jsApiList: ['requestWxFacePictureVerify'] // 必填,需要使用的JS接口列表
});
入参
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
appId | 调用此 jsapi 的公众号 appid | string | 是 |
name | 需要校验的姓名 | string | 是 |
idCard | 需要校验的身份证号 | string | 是 |
出参
名称 | 描述 | 类型 |
---|---|---|
code | 状态码 | number |
result | 比对结果 | object |
message | 提示信息 | string |
比对结果
名称 | 描述 | 类型 |
---|---|---|
err_code | 人脸认证错误码(err_code == 0 成功) | number |
err_msg | 人脸认证错误信息 | string |
verify_result | 本次认证结果凭据。 后续获取明细使用 | string |
安装
bash
npm install @lkcloud/common-jssdk
使用
js
import { faceCertification } from '@lkcloud/common-jssdk'
faceCertification({
appId: '',
name: '',
idCard: ''
}).then((res) => {
console.log(res)
})
json
{
"code": 0,
"result": {
"err_code": 0,
"err_msg": "",
"verify_result": "xxxxxxxxxxx"
}
}
获取识别结果明细
请求参数
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
customer_id | 商户标识 | string | 是 |
verify_result | jsapi 得到的验证参数 | string | 是 |
返回参数
名称 | 描述 | 类型 | 备注 |
---|---|---|---|
identify_ret | 验证结果 | int | 0通过 1不通过 |
接口示例
参数示例
json
{
"customer_id": "12345",
"verify_result": ""
}
json
{
"message": "成功",
"code": 1,
"data": {
"identify_ret": 0
}
}
SDK示例
Java
public class SDKExample {
public static void main(String[] args) {
// Java示例:初始化SDK并调用一个方法
LopClient lopSdkClient = new LopClient("服务地址", "应用ID", "应用私钥", "UTF-8");
Map<String, Object> request = new HashMap<>();
request.put("customer_id", "");
request.put("verify_result", "");
String data = JSONUtil.toJsonStr(request);
String response = lopSdkClient.InvokeMethod("mapi.fwc.face.check", data);
}
}
C#
using System;
using LopSdk;
public class SDKExample {
public static void Main() {
var lopSdkClient = new LopSdkClient("服务地址", "应用ID", "应用私钥", "开放平台公钥");
var data = new
{
customer_id = "",
verify_result = ""
};
string response = await lopSdkClient.InvokeMethodAsync("mapi.fwc.face.check", data);
}
}