创建用户
更新时间:2023-05-05
创建用户
接口描述
本接口用于生成用户在区块链地址即address。
请求结构
JSON
1POST /saas/openapi/econtract/v1/account/create 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 "account_info":{
13 "thirdparty_account_id":"thirdparty_account_id",
14 "thirdparty_type":"thirdparty_type"
15 },
16 "mobile":"mobile",
17 "realname":"realname",
18 "idcard":"idcard",
19 "email":"email"
20 }
21}
请求头域
- 除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
---|---|---|---|---|
bxeoContent | object | 是 | RequestBody参数 | body共用字段头 |
+account_info | object | 是 | RequestBody参数 | 帐号信息,由下方两个字段构成 |
++thirdparty_account_id | string | 是 | RequestBody参数 | 接入方用户唯一标识,由接入方自行指定 |
++thirdparty_type | string | 否 | RequestBody参数 | 接入方用户类型,接入方可用于区分用户所属渠道,针对不同渠道为同一用户生成不同address。 |
+mobile | string | 是 | RequestBody参数 | 用户手机号,根据sk进行aes-128-ecb对称加密,加密方式见加密文档 |
+realname | string | 否 | RequestBody参数 | 用户真实姓名,仅限置信渠道使用,非置信渠道强制清除,根据sk进行aes-128-ecb对称加密,加密方式见加密文档 |
+idcard | string | 否 | RequestBody参数 | 用户真实身份证号,仅限置信渠道使用,非置信渠道强制清除,根据sk进行aes-128-ecb对称加密,加密方式见加密文档 |
string | 否 | RequestBody参数 | 用户邮箱,根据sk进行aes-128-ecb对称加密,加密方式见加密文档 |
响应头域
- 除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 说明 |
---|---|---|
code | int | 错误码 0为成功,其他可参考常用错误码 |
data | object | 返回的主体信息,接口返回的具体业务信息均在data下,所有接口通用 |
+address | string | 用户在BXEO系统中的唯一身份标识,业务方需仔细记录。BXEO主业务流程接口均需要 address参数表明用户身份 |
请求示例
JSON
1POST /saas/openapi/econtract/v1/account/create 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 "account_info":{
13 "thirdparty_account_id":"1",
14 "thirdparty_type":"thirdparty_type"
15 },
16 "mobile":"pppVIoNOIVxNdxn1ywEL7Q==",
17 "realname":"pppVIoNOIVxNdxn1ywEL7Q==",
18 "idcard":"pppVIoNOIVxNdxn1ywEL7Q==",
19 "email":"pppVIoNOIVxNdxn1ywEL7Q=="
20 }
21}
响应示例
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 "address": "YHePxpvYoFAK6xAdsEVGRWsvhJZvJme3w"
9 }
10}