主要使用场景：组织机构接口7.0
机构、学校等组织的获取所有子部门列表，包括N层子部门
获取接口访问凭证：accessToken
| url | https://gateway.tianyuyun.com/user/openapi/org/get-org-child-list?org_id=***&accessToken={{accessToken}} |
| 请求方式 | get |
| 是否需要鉴权 | 是 |
| 请求数限制 | 否 |
| 接口方向 | 第三方应用->开放平台 |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
1 |
org_id |
必选 |
String |
机构、学校等组织id | |
2 |
parent_id |
可选 |
String |
父节点id,查下级部门时不会包含当前部门(如果父节点和机构、学校节点相同，且is_all等于1时，等同于查所有部门) | |
3 |
is_all |
可选 |
String |
是否查下N级节点(1是，0否)，默认1 |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
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 |
部门类型("1": "机构","2": "学校","3": "校区","4": "部门","5": "学段","6": "年级","7": "班级","8": "企业机构","9": "教学工作室","10": "平台") | |
3.5 |
display_order |
必选 |
int |
部门排序 |
请求示例
https://gateway.tianyuyun.com/user/openapi/org/get-org-child-list?org_id=123&accessToken={{accessToken}}
返回示例
{
"code": "000000",
"message": "成功",
"result": {
"count": 3,
"list": [
{
"org_id": "1111111",
"org_name": "财务部",
"org_type": "4",
"parent_id": "111",
"display_order": "1"
}
]
}
}
鄂公网安备 42018502000485号