发起个人刷脸实名认证
接口描述
- 申请刷脸地址进行人脸识别认证
接口地址
/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字段传入值不在支持范围内 |