H5人脸认证

接口说明

[!NOTE]
君子签提供单独的H5人脸识别服务,该接口主要用于个人进行人脸识别,确保是否是本人。该接口涉及到人脸识别费用,如果未购买需要联系商务进行购买。

注:获取到人脸URL地址后,链接地址有效期30分钟,一个链接只能打开一次,不管是否验证再次打开同一链接则失效,需要重新获取新的人脸URL地址。

http请求方式

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

http请求地址

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

http请求参数

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

参数 类型 是否必填 默认值 说明
orderNo string * 订单号,最大支持32个字符
name string * 姓名
identityCard string * 身份证号
backUrl string * 同步回调地址
startFrom int * 启动方式1=browser :表示在浏览器启动刷脸,2=app :表示在 app 里启动刷脸,默认值为browser
notifyUrl string ? 人脸结果异步通知地址
complexity string ? 2 人脸难易度 , 1简单模式(不推荐使用), 2正常模式, 3困难模式,默认不传,使用2正常模式

代码实现

JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
        //构建请求参数
        Map<String,Object> params=new HashMap<>();
        params.put("orderNo","XXXXXXXXXXX");//
        params.put("name","易凡翔");//
        params.put("identityCard","50024XXXXXXXXXX");//
        params.put("backUrl","http://xxx.xx.xx");//

        ResultInfo<Void> ri= requestUtils.doPost("/v2/auth/startH5Face",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
    "orderNo" => "XXXXXXXXXXX",
    "name" => "易XX",
    "identityCard" => "50024019XXXXXXXXXX",
    "backUrl" =>"http://xxx.xx.xx"//启动方式1=browser :表示在浏览器启动刷2=app :表示在 app 里启动刷脸 默认值为browser
    //"startFrom" => 1
);

//发起请求
$response=$requestUtils->doPost("/v2/auth/startH5Face",$request);

http返回参数

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

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

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

参数 类型 是否必返回 说明
startFaceUrl string * 人脸验证启动url

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

//正确响应:
{"data":{"startFaceUrl":"https://XX.XXXX.XXX/api/...."},"success":true}
//错误响应:
{"msg":"3-姓名或身份证不合法","resultCode":"BUSINESS_ERROR","success":false}

results matching ""

    No results matching ""