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