账户管理接口
所有文档

          相关参考 Reference

          账户管理接口

          创建账户

          接口描述

          创建账户,并自动成为当前企业组织的成员。

          请求调用成功后,账户状态为未激活;系统将向账户指定的手机发送确认链接,用户点击链接后即确认手机号的绑定,完成激活。

          账户创建激活后系统为其分配了随机密码,如需登录控制台,请前往智能云登录页-云账号-忘记密码,通过绑定手机号进行密码重置。

          请求结构

          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

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          AccessKey对象

          请求示例

          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
          上一篇
          企业组织管理接口
          下一篇
          邀请管理接口