全国高校查询API【Plus版】集成指南
引言
在当今信息化迅速发展的时代,教育领域也不例外地迎来了数字化转型的浪潮。随着高考制度的不断改革和完善,考生和家长对于院校信息的需求也日益增长。通过此API可以了解全国相关高校的基本信息。
快速开始
注册与认证
1.注册起零API服务平台(https://api.istero.com)
2.登录控制台,右上角--获取API的TOKEN密钥即可
接口地址
https://api.istero.com/resource/school/query/plus
请求参数
请求头部 | 值 | 说明 | 示例 |
---|---|---|---|
Authorization | TOKEN | 用户中心获取到的TOKEN | 89defae676abd3e3a42b41df17c40096 |
名称 | 类型 | 必填 | 默认值 | 描述 | 示例 |
---|---|---|---|---|---|
token | string | 否 | 无 | 如传入Authorization,此参数可以忽略 | 89defae676abd3e3a42b41df17c40096 |
name | string | 否 | 无 | 高校名称 | 杭州 |
page | int | 否 | 1 | 页数 | 1 |
location | string | 否 | 无 | 所在地 | 杭州 |
nature | string | 否 | 无 | 学校性质 | 理工院校 |
type | string | 否 | 无 | 学校类型 | 大学 |
is_985 | int | 否 | 无 | 是否为985 | 1 |
is_211 | int | 否 | 无 | 是否为211 | 0 |
is_top | int | 否 | 无 | 是否为一流院校 | 0 |
is_top_subject | int | 否 | 无 | 是否有一流学科 | 0 |
is_independent_institutions | int | 否 | 无 | 是否有独立院校 | 0 |
is_higher | int | 否 | 无 | 是否为示范高职院校 | 0 |
is_civilian_run | int | 否 | 无 | 是否为民办学校 | 0 |
is_accept_vocational | int | 否 | 无 | 是否招收专科 | 0 |
is_accept_dr | int | 否 | 无 | 是否招收博士 | 0 |
is_accept_master | int | 否 | 无 | 是否招收硕士 | 0 |
is_accept_undergraduate | int | 否 | 无 | 是否招收本科 | 0 |
GET请求实例
响应数据
{
"code": 200,
"data": [
{
"name": "北京大学",
"location": "北京市",
"nature": "综合大学",
"type": "大学",
"is_985": true,
"is_211": true,
"is_top": true,
"is_top_subject": false,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": true,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "中国人民大学",
"location": "北京市",
"nature": "综合大学",
"type": "大学",
"is_985": true,
"is_211": true,
"is_top": true,
"is_top_subject": false,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "清华大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": true,
"is_211": true,
"is_top": true,
"is_top_subject": false,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "北京交通大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true,
"is_top": false,
"is_top_subject": true,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "北京工业大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true,
"is_top": false,
"is_top_subject": true,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": true,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "北京航空航天大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": true,
"is_211": true,
"is_top": true,
"is_top_subject": false,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "北京理工大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": true,
"is_211": true,
"is_top": true,
"is_top_subject": false,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "北京科技大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true,
"is_top": false,
"is_top_subject": true,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "北方工业大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": false,
"is_top": false,
"is_top_subject": false,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": false,
"is_accept_master": true,
"is_accept_undergraduate": true
},
{
"name": "北京化工大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true,
"is_top": false,
"is_top_subject": true,
"is_independent_institutions": false,
"is_higher": false,
"is_civilian_run": false,
"is_accept_vocational": false,
"is_accept_dr": true,
"is_accept_master": true,
"is_accept_undergraduate": true
}
],
"message": ""
}
响应数据说明
名称 | 描述 | |
---|---|---|
code | 响应码 | |
data | name | 院校名称 |
location | 所在地 | |
nature | 学校性质 | |
type | 类型 | |
is_985 | 是否为985 | |
is_211 | 是否为211 | |
is_top | 是否为一流院校 | |
is_top_subject | 是否有一流学科 | |
is_independent_institutions | 是否有独立院校 | |
is_higher | 是否为示范高职院校 | |
is_civilian_run | 是否为民办学校 | |
is_accept_vocational | 是否招收专科 | |
is_accept_dr | 是否招收博士 | |
is_accept_master | 是否招收硕士 | |
is_accept_undergraduate | 是否招收本科 | |
message | 错误信息,仅在响应码非“200”时返回数据 |
响应码参照
代码 | 描述 |
---|---|
200 | 数据返回成功 |
400 | 数据返回错误,“message”显示错误信息 |
401 | TOKEN为空 |
402 | 接口不存在 |
403 | 接口请求失败 |
404 | TOKEN错误/鉴权失败 |
405 | IP白名单规则拦截 |
406 | Referer白名单规则拦截 |
407 | 接口维护中 |
408 | 接口已停止服务 |
500 | 接口服务器错误 |
501 | 余额不足,仅付费接口会出现此状态码 |
502 | 违反平台协议,账号被封锁 |
案例应用场景
第三方教育服务平台
各类第三方教育服务平台,如在线课程提供商、留学中介等,也可以通过集成全国院校查询API来增强其服务内容。例如,一家在线课程平台可以在用户注册时,根据用户的地理位置和学习目标,推荐相关的院校及其开设的相关课程;或者一家留学中介机构可以使用API帮助学生查找国外合作院校在中国境内的分校或合作项目,拓宽留学选择。
高考志愿填报系统
为考生与家长提供全国院校相关信息查询,针对高校是否为211、985以及是否包含一流学科等信息进行参考评估
总结
全国院校查询API不仅是一个简单的信息查询工具,更是连接教育资源与用户需求的重要桥梁。它通过提供标准化、结构化的院校数据,极大地便利了学生、家长、教育工作者以及相关机构的工作和生活。