企业组织管理接口
所有文档

          相关参考 Reference

          企业组织管理接口

          创建企业组织

          接口描述

          创建企业组织。

          调用者的账户自动成为企业组织的master account。

          创建企业组织,需要先完成账户的实名认证;同时账户下没有待处理的企业组织邀请。

          请求结构

          POST /v1/organization HTTP/1.1
          Host: organization.bj.baidubce.com
          Authorization: authorization string
          
          {
              "name":"name",
              "description": "description"
          }

          请求头域

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

          请求参数

          名称 类型 位置 描述 是否必须
          name String RequestBody参数 企业组织名称
          description String RequestBody参数 企业组织描述

          响应头域

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

          响应参数

          Organization对象

          请求示例

          POST /v1/organization
          host: organization.bj.baidubce.com
          content-type: application/json
          Content-Length: 54
          Authorization: AuthorizationString
          
          {"name":"testOrg", "description": "test organization"}

          响应示例

          HTTP/1.1 201 Created
          Content-Type: application/json;charset=UTF-8
          X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
          Server: BWS
          
          {
              "createTime": "2018-08-29T04:02:23Z",
              "description": "test organization",
              "id": "25fc10b3bc61437aa72b35f76515b375",
              "masterAccountId": "9fe073b94d6041c7b13617db3a52761e",
              "masterAccountMobile": "13312345678",
              "name": "testOrg"
          }

          查看企业组织

          接口描述

          查看当前所在的企业组织。

          请求结构

          GET /v1/organization HTTP/1.1
          Host: organization.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          无。

          响应头域

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

          响应参数

          账户仅能加入一个企业组织,故列表中最多只有一条记录;若未创建或加入过账户组,则返回空列表。

          名称 类型 描述
          Organizations List<Organization> 企业组织列表

          请求示例

          GET /v1/organization
          host: organization.bj.baidubce.com
          Authorization: AuthorizationString

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
          Server: BWS
          
          [
              {
                  "description": "",
                  "createTime": "2018-08-29T04:02:23Z",
                  "masterAccountMobile": "13312345678",
                  "masterAccountId": "9fe073b94d6041c7b13617db3a52761e",
                  "id": "25fc10b3bc61437aa72b35f76515b375",
                  "name": "test"
              }
          ]

          更新企业组织

          接口描述

          修改企业组织信息。

          请求结构

          PUT /v1/organization/{organizationId} HTTP/1.1
          Host: organization.bj.baidubce.com
          Authorization: authorization string
          
          {
              "name": "name",
              "description": "description"
          }

          请求头域

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

          请求参数

          名称 类型 位置 描述 是否必须
          organizationId String URL参数 企业组织ID
          name String RequestBody参数 企业组织名称
          description String RequestBody参数 企业组织描述

          响应头域

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

          响应参数

          Organization对象

          请求示例

          PUT /v1/organization/25fc10b3bc61437aa72b35f76515b375
          host: organization.bj.baidubce.com
          content-type: application/json
          Content-Length: 51
          Authorization: AuthorizationString
          
          {"name":"test", "description": "test organization"}

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          X-Bce-Request-Id: bcc416b6-0bd0-4c3f-aa77-6b211bacb630
          Server: BWS
          
          {
              "description": "test organization",
              "createTime": "2018-08-29T04:02:23Z",
              "masterAccountMobile": "13312345678",
              "masterAccountId": "9fe073b94d6041c7b13617db3a52761e",
              "id": "25fc10b3bc61437aa72b35f76515b375",
              "name": "test"
          }
          上一篇
          通用说明
          下一篇
          账户管理接口