申请个人授权认证
更新时间：2023-05-05
个人授权认证-二要素认证
接口描述
本接口用于对个人用户进行二要素实名认证，可指定期望实名人，以及制定页面错误码信息，本方式采用页面嵌套的形式，由BXD系统提供实名页面，用户在实名页面填写基本信息，填写完成后可跳转至接入方指定路由，不推荐该方式。
请求结构
JSON
1POST /saas/openapi/econtract/v1/account/certification/url HTTP/1.1
2Host: xuper.baidu.com
3Content-Type: application/json;charset=utf-8
4X_BXEO_APP_ID: ak string
5X_BXEO_NONCE: nonce string
6X_BXEO_SIGN: sign string
7X_BXEO_TIMESTAMP: new time string
8X_BXEO_CONTENTMD5: body md5 string
9X_BXEO_SIGNTYPE: HMAC-SHA256
10{
11 "bxeoContent": {
12 "address": "V9mA9Gwo3JPUzwX5DDPJa8HTPfnKfLWJG",
13 "callback_url": "https://xuper.baidu.com/n/console/econtract?channel_tp=econtract_cms_uc&account_type=2#econtract/home",
14 "expect_name":"张三",
15 "expect_msg":{
16 "11410046":"个人实名认证信息与供应商主联系人信息不符，请先联系百度集团采购部更新供应商主联系人信息。"
17 }
18 }
19}请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| bxeoContent | object | 是 | RequestBody参数 | body共用字段头 |
| +address | string | 是 | RequestBody参数 | BEXO系统中用户唯一身份标识 |
| +callback_url | string | 是 | RequestBody参数 | 完成认证后，需要跳转的路由 |
| +expect_name | string | 否 | RequestBody参数 | 期望认证人姓名 |
| +expect_msg | string | 否 | RequestBody参数 | 期望认证错误提示，目前仅支持错误码11410046的制定 |
响应头域
- 除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | int | 错误码 0为成功，其他可参考常用错误码 |
| data | object | 返回的主体信息,接口返回的具体业务信息均在data下，所有接口通用 |
| +url | string | 认证地址 |
| +access_token | string | 认证标识 |
请求示例
JSON
1POST /saas/openapi/econtract/v1/account/certification/url HTTP/1.1
2Host: xuper.baidu.com
3Content-Type: application/json;charset=utf-8
4X_BXEO_APP_ID: lf2a69d4dff7dc9f3a462719da8bb942
5X_BXEO_NONCE: 12333312111
6X_BXEO_SIGN: lf2a69d4dff7dc9f3a462719da8bb942
7X_BXEO_TIMESTAMP: 1660733105
8X_BXEO_CONTENTMD5: asdaxasdsasdasdasdas
9X_BXEO_SIGNTYPE: HMAC-SHA256
10{
11 "bxeoContent": {
12 "address": "V9mA9Gwo3JPUzwX5DDPJa8HTPfnKfLWJG",
13 "callback_url": "https://xuper.baidu.com/n/console/econtract?account_typ=5",
14 "expect_name":"张三",
15 "expect_msg":{
16 "11410046":"个人实名认证信息与供应商主联系人信息不符，请先联系百度集团采购部更新供应商主联系人信息。"
17 }
18 }
19}响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 18 Apr 2022 03:28:11 GMT
4{
5 "code": 0,
6 "msg": "Success",
7 "data": {
8 "url": "http://xuper-test.bcc-szth.baidu.com:8978/n/console/auth/certify#/?access_token=c5ec196501ece8398903fe933a64933db",
9 "access_token": "c5ec196501ece8398903fex933a6493db"
10 }
11}