相关参考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"
    }
    上一篇
    通用说明
    下一篇
    账户管理接口