top
关闭

开发者登录

组织机构接口

主要使用场景:组织机构接口7.0

1、获取学校教育属性的子列表7.0

基础 需要授权

该接口能获取到学校下所有的校区、学段、年级、班级子列表

前置条件

获取接口访问凭证:accessToken

请求说明

urlhttps://gateway.tianyuyun.com/user/openapi/org/get-edu-child-list?org_id=12121&accessToken={{accessToken}}
请求方式get
是否需要鉴权
请求数限制
接口方向第三方应用->开放平台

参数说明

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

1

org_id

必选

String

学校id

2

school_id

可选

String

所属校区id

3

org_type

可选

String

部门类型(3校区,5学段,6年级,7班级)

4

parent_id

可选

String

父级编号,多个使用英文逗号分隔

返回说明

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

1

code

必选

string

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

2

message

必选

string

结果描述

3

result

可选

json[]

结果描述

3.1

org_id

必选

string

部门id

3.2

org_name

必选

string

部门名称

3.3

parent_id

必选

string

父部门id

3.4

org_type

必选

string

部门类型(3校区,5学段,6年级,7班级)

示例

请求示例
https://gateway.tianyuyun.com/user/openapi/org/get-edu-child-list?org_id=12121&accessToken={{accessToken}}
返回示例
{
  "code": "000000",
  "message": "成功",
  "result": {
    "count": 1,
    "list": [
      {
        "org_id": "111111",
        "org_name": "校区一",
        "org_type": "3",
        "parent_id":'111'
      }
    ]
  }
}