一、接入流程

二、获取 authToken 和认证页面地址接口

接口说明

网易易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

请求地址

名称	值
HTTP URL	https://verify.dun.163.com/v1/face/liveness/h5/auth
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："application/x-www-form-urlencoded"

请求参数

请求参数由请求公共参数和请求业务参数两部分组成，通用参数见请求通用字段

名称	类 型	必填	最大长度	描述
name	String	是	32	用户真实姓名，以身份证上姓名为准
cardNo	String	是	18	用户身份证号码，目前支持一代/二代身份证，号码必须为18位或15位，末尾为x的需要大写为X
redirectUrl	String	是	512	认证成功后，重定向的URL

响应返回码

响应返回码见：响应返回码

响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段

参数名称	类型	必须返回	描述
authUrl	String	是	认证地址
authToken	String	是	认证 Token

响应结果示例

当认证成功时，输出示例如下：

{
  "code": 200,
  "msg": "ok",
  "result": {
    "authUrl": "xxx",
    "authToken": "xxx "
  }
}

三、authToken 校验接口

接口说明

网易易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

请求地址

名称	值
HTTP URL	https://verify.dun.163.com/v1/face/liveness/h5/recheck
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："application/x-www-form-urlencoded"

请求参数

请求参数由请求公共参数和请求业务参数两部分组成，通用参数见请求通用字段

名称	类 型	必填	最大长度	描述
authToken	String	是	32	认证 Token

响应返回码

响应返回码见：响应返回码

响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段

响应结果示例

人脸核身：详情参考交互式人脸核身接口： 认证成功时，输出示例如下：

{
  "code": 200,
  "msg": "ok",
  "result": {
    "taskId": "6ddcf5e32f2143b9a66f3e42c604374a",
    "picType": 1,
    "avatar": "https://dun-au-authentication.vod.126.net/9dde6e940e174145b0024cf0bd60d4cb-0-0?Signature=iuH5PTh7dxpg2il5GlCPoL4ePTSeJ1v1AlndWrlLLB4%3D&Expires=1766559711&NOSAccessKeyId=6916763c068e49bb9c235018e2c88911",
    "status": 1,
    "reasonType": 1,
    "isPayed": 1,
    "similarityScore": 0.9940698,
    "faceMatched": 1,
    "faceAttributeInfo": null,
    "extInfo": {
      "suspectedNonageFlag": false
    }
  }
}

四、前端重定向参数

认证成功后，跳转到重定向地址时会携带以下参数

名称	类 型	必填	最大长度	描述
authToken	String	是	32	认证 token