账户管理接口
更新时间：2020-02-25
创建账户
接口描述
创建账户，并自动成为当前企业组织的成员。
请求调用成功后，账户状态为未激活；系统将向账户指定的手机发送确认链接，用户点击链接后即确认手机号的绑定，完成激活。
账户创建激活后系统为其分配了随机密码，如需登录控制台，请前往智能云登录页-云账号-忘记密码，通过绑定手机号进行密码重置。
请求结构
POST /v1/organization/{organizationId}/account HTTP/1.1
Host: organization.bj.baidubce.com
Authorization: authorization string
{
"name": "name",
"mobile": "mobile",
"description": "description"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| organizationId | String | URL参数 | 企业组织ID | 是 |
| name | String | RequestBody参数 | 账户名称,全局唯一 | 是 |
| mobile | String | RequestBody参数 | 账户绑定手机 | 是 |
| description | String | RequestBody参数 | 账户描述 | 否 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
Account对象
请求示例
POST /v1/organization/25fc10b3bc61437aa72b35f76515b375/account
host: organization.bj.baidubce.com
Authorization: AuthorizationString
{"name":"accountasdx", "description": "test organization account", "mobile":"13312345678"}响应示例
HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
Server: BWS
{
"status": "CREATING",
"description": "test organization",
"mobile": "*******5678",
"joinTime": "2019-09-24T01:45:43Z",
"id": "bfdbd1e6316b4729ab49f2cb25710068",
"name": "accountasdx"
}查看账户
接口描述
查看企业组织中的指定账户。
请求结构
GET /v1/organization/{organizationId}/account/{accountId} HTTP/1.1
Host: organization.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| organizationId | String | URL参数 | 企业组织ID | 是 |
| accountId | String | URL参数 | 账户ID | 是 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
Account对象
请求示例
GET /v1/organization/25fc10b3bc61437aa72b35f76515b375/account/a7409103bba94b0c8edf446a22c72bf7
host: organization.bj.baidubce.com
Authorization: AuthorizationString响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
Server: BWS
{
"status": "ACTIVE",
"description": "",
"mobile": "+86********243",
"joinTime": "2019-09-23T11:16:51Z",
"id": "a7409103bba94b0c8edf446a22c72bf7",
"name": "bceaccount123"
}列举账户
接口描述
列出企业组织下的全部账户列表。
请求结构
GET /v1/organization/{organizationId}/account HTTP/1.1
Host: organization.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| organizationId | String | URL参数 | 企业组织ID | 是 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| accounts | List<Account> | 账户对象的列表 |
请求示例
GET /v1/organization/25fc10b3bc61437aa72b35f76515b375/account
host: organization.bj.baidubce.com
Authorization: AuthorizationString响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
Server: BWS
[
{
"status": "ACTIVE",
"description": "",
"mobile": "+86********243",
"joinTime": "2019-09-23T11:16:51Z",
"id": "a7409103bba94b0c8edf446a22c72bf7",
"name": "bceaccount123"
}
]创建账户的AccessKey
接口描述
为已经激活的账户创建一组AccessKey。
调用此接口，要求账户已经通过短信链接完成激活确认。
请求结构
POST /v1/organization/{organizationId}/account/{accountId}/accesskey HTTP/1.1
Host: organization.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| organizationId | String | URL参数 | 企业组织ID | 是 |
| accountId | String | URL参数 | 账户ID | 是 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
请求示例
POST /v1/organization/25fc10b3bc61437aa72b35f76515b375/account/a7409103bba94b0c8edf446a22c72bf7/accesskey
host: organization.bj.baidubce.com
Authorization: AuthorizationString响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
Server: BWS
{
"secret": "1234567890abcdef98e338e20217a1c7",
"id": "eb848c3507344564bd4ab7b7da1cdd70",
"createTime": "2019-09-23T11:24:10Z"
}子账户开启企业组织财务
接口描述
为子账户开启企业组织财务功能。
企业组织财务功能要求子账户实名认证名称需和主账户一致；无账户余额、无线下合同;开票策略需为按消费开票且无可开票金额、无欠票。
请求结构
PUT /v1/organization/{organizationId}/account/{accountId}?consolidate_billing HTTP/1.1
Host: organization.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| organizationId | String | URL参数 | 企业组织ID | 是 |
| accountId | String | URL参数 | 子账户ID | 是 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
无。
请求示例
PUT /v1/organization/25fc10b3bc61437aa72b35f76515b375/account/8760c415d06c47169c3561d51538d75a?consolidate_billing
host: organization.bj.baidubce.com
Authorization: AuthorizationString响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
content-length: 0
Server: BWS离开企业组织
接口描述
账户离开企业组织。
企业组织中快速创建的账户，需联系客户经理换绑成完整账户后方可离开企业组织。
请求结构
PUT /v1/organization/{organizationId}/account/{accountId}?leave HTTP/1.1
Host: organization.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| organizationId | String | URL参数 | 企业组织ID | 是 |
| accountId | String | URL参数 | 子账户ID | 是 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
无。
请求示例
PUT /v1/organization/25fc10b3bc61437aa72b35f76515b375/account/8760c415d06c47169c3561d51538d75a?leave
host: organization.bj.baidubce.com
Authorization: AuthorizationString响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
X-Bce-Request-Id: fc96771d-f2a3-4b1a-8ed2-ea7665461baf
content-length: 0
Server: BWS