相关参考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
    一篇
    企业组织管理接口
    一篇
    邀请管理接口