发起个人刷脸实名认证

接口描述

  • 申请刷脸地址进行人脸识别认证

接口地址

  • /v2/identity/auth/api/individual/face

请求方式

  • POST
  • 请求报文体采用Json数据格式,编码方式采用UTF-8编码

请求参数

参数名 说明 参数类型 是否必填 类型
name 姓名 body string
idNo 身份证号 body string
faceauthMode 人脸认证方式,详见:个人已支持认证方式对照表 body string
callbackUrl 刷脸完成后业务重定向地址 body string
contextId 对接方业务上下文id,将在异步通知及跳转时携带返回对接方 body string
notifyUrl 认证结束后异步通知地址,具体见"异步通知"章节说明 body string

请求示例

POST /v2/identity/auth/api/individual/face HTTP/1.1

{
    "name":"张三",
    "idNo":"320926195511175276",
    "faceauthMode": "TENCENT",
    "callbackUrl":"http://www.baidu.com",
    "contextId": "f0a7927d-c5f9-4652-a053-1130d86c8fa8",
    "notifyUrl": "http://xxx.xx.cn/esign/realname/callback"
}

响应参数

参数名 说明 类型
code int 接口响应结果码
message string 接口响应结果描述
data object 接口响应结果数据
flowId string 实名流程Id
authUrl string e签宝短链接地址
originalUrl string 刷脸原始地址
expire long 链接失效时间,毫秒值

响应示例

  {
    "code": 0,
    "message": "成功”,
    "data":{
        "flowId": "836551334533533698",
        "authUrl": "https://testt.tsign.cn/VozGmAcZHH6Q",
        "originalUrl": "https://zmcustprod.zmxy.com.cn/certify/guide.htm?zhima_exterface_invoke_assign_target=0af8456f15624070983926420e1584&zhima_exterface_invoke_assig_sign=HrE0w3R3FNQA61ehejxL64Gn_CDSrZi_gP6maruW0t146w7gdo76iJnOHSsFg_8ZwUU1CPY4iduCm2pZ7GJKiavEfa4d7U4ujAlJtS_3hPIB-uM2lKHYv_96ptw6hrKnuMA5396JnBMugBlfDqbne2wQjzHLpg9ndoE6HesW_uY",
        "expire":1562406694000
    }
  }

错误码

错误码 错误信息 错误原因
30500101 参数错误:刷脸方式暂不支持 faceMode字段传入值不在支持范围内

results matching ""

    No results matching ""