文档首页 > > API参考> 管理企业> 管理企业多账号> 查询企业组织结构

查询企业组织结构

分享
更新时间: 2019/09/20 GMT+08:00

功能介绍

企业主账号在客户自建平台查询企业组织结构。

注意事项:

该接口只允许使用企业主账号AK/SK或者Token调用。

URI

GET /v1.0/{domain_id}/customer/customer-mgr/enterprise-organization

参数说明请参见下表。

表1 路径参数

参数

是否必选

取值范围

描述

domain_id

最大长度:64

客户账号ID,只能使用企业主账号。

获取方法请参见如何获取customer_id/domain_id

表2 查询参数

参数

是否必选

参数类型

取值范围

描述

recursive_query

Integer

-

是否递归查询:

0:不递归(默认);

1:递归。

注:如果不递归,只返回起始节点的直接子节点。

party_id

String

-

指定的partyID,可以是root_party_id,也可以是child_party_id,如果输入这个参数,只查询这个party底下的所有子节点。

请求消息

请求参数

无。

请求示例

GET /v1.0/{domain_id}/customer/customer-mgr/enterprise-organization
Host: Host Server
Content-Type: application/json
X-Sdk-Date: request time
Authorization: authorization

响应消息

响应参数

参数

是否必选

参数类型

取值范围

描述

error_code

String

最大长度:20

状态码。具体请参考状态码,只有失败才返回该字段。

error_msg

String

最大长度:1000

错误描述信息。只有失败才返回该字段。

rootPartyId

String

最大长度:20

根的party ID,如果请求有party_id,则该参数无值。

rootPartyName

String

-

组织根节点的名称,如果请求有party_id,则该参数无值。

注:组织根节点没有设置组织名称时,可能为空。

emChildPartyNodes

List<EmChildPartyNode>

-

企业管理子Party节点列表,具体参考表3

注:每一层的节点列表需要按relation_type升序排序。

表3 EmChildPartyNode

参数

是否必选

参数类型

取值范围

描述

party_relation_id

String

最大长度:20

实体关系ID。

child_party_id

String

最大长度:20

子Party的ID。

child_party_name

String

-

子Party的名称。

em_child_party_nodes

List<EmChildPartyNode>

-

子Party节点列表。

注:每一层的节点列表需要按relation_type升序排序。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  

{
    "rootPartyId": "121",
    "rootPartyName": "ruantong",
    "emChildPartyNodes": [
        {
            "party_relation_id": "163",
            "child_party_id": "370",
            "child_party_name": "afd",
            "em_child_party_nodes": []
        },
        {
            "party_relation_id": "166",
            "child_party_id": "373",
            "child_party_name": "jlk",
            "em_child_party_nodes": []
        },
        {
            "party_relation_id": "135",
            "child_party_id": "160",
            "child_party_name": "cdf,
            "em_child_party_nodes": []
        },
        {
            "party_relation_id": "117",
            "child_party_id": "142",
            "child_party_name": "qwe",
            "em_child_party_nodes": []
        },
        {
            "party_relation_id": "108",
            "child_party_id": "131",
            "child_party_name": "yui",
            "em_child_party_nodes": []
        },
        {
            "party_relation_id": "118",
            "child_party_id": "143",
            "child_party_name": "asd",
            "em_child_party_nodes": []
        }
    ]
}

状态码

HTTP状态码

错误码

错误描述

400

CBC.0100

输入参数校验失败。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区