申请个人刷脸授权认证
更新时间：2023-05-05
申请个人刷脸授权认证
接口描述
本接口用于对个人用户进行实名认证，申请认证获取实名链接，根据要求完成上传身份证以及刷脸操作后实名成功，实名成功后将跳转至接入方指定的路由，同步刷脸结果，需要接入方请求获取刷脸详情接口进行同步，否则无法将结果同步至BEXO系统当中，推荐使用该方式进行实名认证。
请求结构
POST /saas/openapi/econtract/v1/face/real/url HTTP/1.1
Host: xuper.baidu.com
Content-Type: application/json;charset=utf-8
X_BXEO_APP_ID: ak string
X_BXEO_NONCE: nonce string
X_BXEO_SIGN: sign string
X_BXEO_TIMESTAMP: new time string
X_BXEO_CONTENTMD5: body md5 string
X_BXEO_SIGNTYPE: HMAC-SHA256
{
"bxeoContent": {
"address": "g1DZKxN2w5r72k6u7hpq7KGKQY8RFjSFL",
"success_url":"https://xuper.baidu.com",
"failed_url":"https://www.baidu.com"
}
}请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| bxeoContent | object | 是 | RequestBody参数 | body共用字段头 |
| +address | string | 是 | RequestBody参数 | BEXO系统中用户唯一身份标识 |
| +success_url | string | 是 | RequestBody参数 | 完成认证成功后，需要跳转的路由 |
| +failed_url | string | 否 | RequestBody参数 | 完成认证失败后，需要跳转的路由 |
响应头域
- 除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码 0为成功，其他可参考常用错误码 |
| data | object | 返回的主体信息,接口返回的具体业务信息均在data下，所有接口通用 |
| +face_url | string | 刷脸认证地址，改地址为H5页面，可生成二维码后用户扫码认证 |
| +verify_token | string | 认证标识，获取刷脸详情时使用 |
请求示例
POST /saas/openapi/econtract/v1/face/real/url HTTP/1.1
Host: xuper.baidu.com
Content-Type: application/json;charset=utf-8
X_BXEO_APP_ID: lf2a69d4dff7dc9f3a462719da8bb942
X_BXEO_NONCE: 12333312111
X_BXEO_SIGN: lf2a69d4dff7dc9f3a462719da8bb942
X_BXEO_TIMESTAMP: 1660733105
X_BXEO_CONTENTMD5: asdaxasdsasdasdasdas
X_BXEO_SIGNTYPE: HMAC-SHA256
{
"bxeoContent": {
"address": "g1DZKxN2w5r72k6u7hpq7KGKQY8RFjSFL",
"success_url":"https://xuper.baidu.com",
"failed_url":"https://www.baidu.com"
}
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 18 Apr 2022 03:28:11 GMT
{
"code": 0,
"msg": "Success",
"data": {
"face_url": "https://brain.baidu.com/face/print/?token=uOMgIXyxq40KB0cxyt26rIQj&successUrl=https%3A%2F%2Fxuper.baidu.com&failedUrl=https%3A%2F%2Fwww.baidu.com",
"verify_token": "uOMgIXyxq40KB0cxyt26rIQj"
}
}