手把手教你接入人脸活体实名认证，提升应用用户体验

活体人脸实名认证接口使用详解，手把手教你接入人脸实名认证

活体人脸实名认证服务是适用于企业用户的身份真实性核验服务。在使用前，请确保您已注册聚合数据账号，并完成企业实名认证。

使用流程

本接口服务搭载真人检测和人脸比对等生物识别技术，配合权威数据源验证，可快速校验自然人的真实身份。支持PC和移动端H5网页接入。

申请接口

注册并登录聚合官网->申请活体人脸实名认证接口
获取接口：apikey

调用接口

认证地址初始化

请求地址：https://apis.juhe.cn/faceid/query
请求方式：post
参数：

示例代码（golang）

每次开始认证前通过调用本接口获取用于浏览器进行实人认证的认证访问链接verify_url。
更多示例代码请看

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    // 基本参数配置
    apiUrl := "https://apis.juhe.cn/faceid/query"
    apiKey := "您申请的调用APIkey"

    // 接口请求入参配置
    requestParams := url.Values{}
    requestParams.Set("key", apiKey)
    requestParams.Set("certName", "姓名")
    requestParams.Set("certNo", "370121xxxxxxxx1040")
    requestParams.Set("orderId", "OD2024052012121212")
    requestParams.Set("model", "1")
    requestParams.Set("returnUrl", "https://local.example.cn/return")
    requestParams.Set("notifyUrl", "")

    // 发起接口网络请求
    resp, err := http.Post(apiUrl, "application/x-www-form-urlencoded", strings.NewReader(requestParams.Encode()))
    if err != nil {
        fmt.Println("网络请求异常:", err)
        return
    }
    defer resp.Body.Close()

    var responseResult map[string]interface{}
    err = json.NewDecoder(resp.Body).Decode(&responseResult)
    if err != nil {
        fmt.Println("解析响应结果异常:", err)
        return
    }
    fmt.Println(responseResult)
}

返回参数：

{
  "reason":"SUCCESS",
  "result":{
    "jh_order_id":"JH79320240513145425BLEnR",
    "verify_url":"http://m.alyms.cn/F4.bTPyEV"
  },
  "error_code":0
}

查询认证结果

当您回跳页面收到请求或收到回调通知之后，可以在服务端通过该接口获取相应的认证状态和认证资料。
请求地址：https://apis.juhe.cn/faceid/search
请求方式：post
参数：

示例代码（golang）

更多示例代码请看

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    // 基本参数配置
    apiUrl := "https://apis.juhe.cn/faceid/search"
    apiKey := "您申请的调用APIkey"

    // 接口请求入参配置
    requestParams := url.Values{}
    requestParams.Set("key", apiKey)
    requestParams.Set("jhOrderId", "JH79320240517095231mUzn9")

    // 发起接口网络请求
    resp, err := http.Post(apiUrl, "application/x-www-form-urlencoded", strings.NewReader(requestParams.Encode()))
    if err != nil {
        fmt.Println("网络请求异常:", err)
        return
    }
    defer resp.Body.Close()

    var responseResult map[string]interface{}
    err = json.NewDecoder(resp.Body).Decode(&responseResult)
    if err != nil {
        fmt.Println("解析响应结果异常:", err)
        return
    }
    fmt.Println(responseResult)
}

返回示例：

具体返回参数说明请移步

{
  "reason": "SUCCESS",
  "result": {
    "passed": "T",
    "message": "身份证号与姓名匹配，且比对成功",
    "jh_order_id": "JH79320240517095231mUzn9",
    "detail": {
      "live_passed": "T",
      "live_code": "200",
      "live_message": "活体检测通过",
      "live_score": "91.11730",
      "certify_passed": "T",
      "certify_code": "200",
      "certify_message": "身份证号与姓名匹配，且比对成功",
      "certify_res": "1",
      "certify_score": "87",
      "img": "https://cn-shanghai-aliyun-cloudauth-1811331075658188.oss-cn-shanghai.aliyuncs.com/verify/1811331075658188/sha4062a2a53d9fe9daa83b918d1ace1_0.jpeg?......."
    }
  },
  "error_code": 0
}