主要使用场景:组织机构接口7.0
该接口能获取到学校下所有的校区、学段、年级、班级子列表
获取接口访问凭证:accessToken
| url | https://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'
}
]
}
}