创建用户
更新时间：2023-05-05
创建用户
接口描述
本接口用于生成用户在区块链地址即address。
请求结构
POST /saas/openapi/econtract/v1/account/create 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":{
"account_info":{
"thirdparty_account_id":"thirdparty_account_id",
"thirdparty_type":"thirdparty_type"
},
"mobile":"mobile",
"realname":"realname",
"idcard":"idcard",
"email":"email"
}
}请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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参数表明用户身份 |
请求示例
POST /saas/openapi/econtract/v1/account/create 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":{
"account_info":{
"thirdparty_account_id":"1",
"thirdparty_type":"thirdparty_type"
},
"mobile":"pppVIoNOIVxNdxn1ywEL7Q==",
"realname":"pppVIoNOIVxNdxn1ywEL7Q==",
"idcard":"pppVIoNOIVxNdxn1ywEL7Q==",
"email":"pppVIoNOIVxNdxn1ywEL7Q=="
}
}响应示例
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": {
"address": "YHePxpvYoFAK6xAdsEVGRWsvhJZvJme3w"
}
}