top
关闭

开发者登录

机构信息类接口

主要使用场景:机构信息类接口

1、机构下级单位、学校列表

基础 需要授权

获取机构下一级组织列表

前置条件

获取接口访问令牌:accessToken

请求说明

urlhttps://api.wuhaneduyun.cn/user/openapi/org-tree/get-child-list
请求方式get
是否需要鉴权
请求数限制
接口方向第三方应用->开放平台

参数说明

序号 字段名 约束 类型 长度 说明

1

org_id

必选

String

-

父级机构id

2

child_type

可选

String

-

限定下级类型(1直属组织,2下级组织,3关联组织),与参数is_filter互斥,不能同时使用,多个使用英文逗号分隔

3

is_filter

可选

Int

-

是否过滤为不同的类型(按照直属,下级,关联3类返回)(1是,0否,默认否,选择1时返回的结构不同,请注意)

4

org_type

可选

String

-

限定查下级机构的类型(1机构,2学校,8企业,9教学工作室),多个使用英文逗号分隔

返回说明

序号 字段名 约束 类型 长度 说明

1

code

必选

string

-

结果编码,000000:成功, 100001:失败

2

message

必选

string

-

结果描述

3

result

可选

json[]

-

结果描述

3.1

org_id

必选

string

-

组织id

3.2

org_name

必选

string

-

组织名称

3.3

org_type

必选

string

-

组织类型,1机构,2学校

3.4

child_type

必选

string

-

所属类别,1直属组织,2下级组织,3关联组织

示例

**请求示例**
https://api.wuhaneduyun.cn/user/openapi/org-tree/get-child-list?org_id=xxx

**返回示例**
{
    "code": "000000",
    "result": [
        {
            "org_id": "xxx",
            "org_name": "xx市教育局",
            "org_type": "1",
            "child_type": "1",
        },
        {
            "org_id": "xxx",
            "org_name": "xx市电教馆",
            "org_type": "1",
            "child_type": "1",
        },
        {
            "org_id": "xxx",
            "org_name": "xx区电育局",
            "org_type": "1",
            "child_type": "2",
        }
    ]
}