主要使用场景：组织机构接口7.0
该接口能获取到校区、学段、年级、班级的详情
获取接口访问凭证：accessToken
| url | https://gateway.tianyuyun.com/user/openapi/org/get-edu-info?org_id=123&accessToken={{accessToken}} |
| 请求方式 | get |
| 是否需要鉴权 | 是 |
| 请求数限制 | 否 |
| 接口方向 | 第三方应用->开放平台 |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
1 |
org_id |
必选 |
string |
节点id |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
1 |
code |
必选 |
string |
结果编码,000000：成功, 100001：失败 | |
2 |
message |
必选 |
string |
结果描述 | |
3 |
result |
必选 |
string |
结果数据 | |
3.1 |
top_org_id |
必选 |
string |
学校id | |
3.1 |
org_id |
必选 |
string |
部门id | |
3.2 |
platform_org_id |
必选 |
string |
原平台组织id | |
3.2 |
grade_number |
可选 |
Int |
年级70版本编号(班级、年级时返回) | |
3.3 |
platform_code |
必选 |
string |
原平台组织平台码 | |
3.3 |
graduation_header_teacher |
可选 |
array |
班主任数据，(班级毕业时返回) | |
3.4 |
org_name |
必选 |
string |
组织名称 | |
3.5 |
org_short_name |
必选 |
string |
组织简称 | |
3.6 |
org_type |
必选 |
string |
组织类型(3:校区,5:学段,6:年级,7班级) | |
3.7 |
create_user_id |
必选 |
string |
创建者id | |
3.8 |
createtime |
必选 |
string |
创建时间 | |
3.9 |
updatetime |
必选 |
string |
更新时间 | |
3.11 |
parent_id |
必选 |
string |
父级节点id | |
3.12 |
group_id |
可选 |
string |
群组id | |
3.13 |
status |
必选 |
string |
状态，0:组织未激活,1:正常,2:解散,3:锁定 | |
3.14 |
certification |
必选 |
string |
认证(0:未认证,1:已认证) | |
3.15 |
flag |
必选 |
string |
标记(0:正常,1:演示,2:测试) | |
3.16 |
level |
必选 |
string |
业务等级(0:无等级,1:等级一,2:等级二) | |
3.17 |
verify_mode |
必选 |
string |
成员加入模式(1允许加入,2不允许加入) | |
3.18 |
top_school_id |
必选 |
string |
校区id(班级、年级、学段、校区时返回) | |
3.19 |
class_number |
可选 |
Int |
班级编号(班级时返回) | |
3.21 |
grade_rule_number |
可选 |
Int |
年级的60版本编号(班级、年级时返回) | |
3.22 |
period_type |
可选 |
Int |
学段类型(班级、年级、学段时返回) | |
3.23 |
grade_year |
可选 |
Int |
入学年份(年级、班级时返回) | |
3.24 |
grade_system |
可选 |
string |
年级的学制类型(年级、班级时返回) | |
3.25 |
grade_system_name |
可选 |
string |
学制名称，(年级、班级时返回) | |
3.26 |
avatar |
可选 |
string |
头像地址，(校区、班级时返回) | |
3.27 |
graduation_is |
可选 |
int |
是否已毕业，(0未毕业,1已毕业;年级、班级时返回) | |
3.28 |
graduation_year |
可选 |
string |
毕业年份，(年级、班级时返回) | |
3.29 |
graduation_school_name |
可选 |
string |
毕业时的学校名称，(班级毕业时返回) | |
3.31 |
top_org_name |
可选 |
string |
学校的名称 | |
3.32 |
org_coding |
可选 |
string |
班级编码(班级时返回) |
请求示例
https://gateway.tianyuyun.com/user/openapi/org/get-edu-info?org_id=123&accessToken={{accessToken}}
返回示例
{
"code": "000000",
"message": "请求成功",
"result": {
"org_id": "c2d2a224-5a9a-11e9-9c82-0200f7b88099",
"platform_org_id": "c2d2a224-asas-11e9-9c82-0200f7b88099",
"platform_code": "999999",
"org_name": "校区一",
"org_short_name": "校区一",
"org_type": "3",
"create_user_id": "af144ae4-cccc-11e9-9c82-0200f7b88099",
"createtime": "1554795635",
"updatetime": "1555126603",
"status": "1",
"certification": "0",
"flag": "0",
"level": "0",
"verify_mode": "0",
"top_org_id": "c2d2a224-dddd-11e9-9c82-0200f7b88099",
"parent_id": "c2d2a224-dddd-11e9-9c82-0200f7b88099",
"top_school_id": "c2d2a224-5a9a-11e9-9c82-0200f7b88099",
"top_org_name": "xxxx学校",
}
}
鄂公网安备 42018502000485号