全国高校查询API集成指南
引言
在当今信息化迅速发展的时代,教育领域也不例外地迎来了数字化转型的浪潮。随着高考制度的不断改革和完善,考生和家长对于院校信息的需求也日益增长。通过此API可以了解全国相关高校的基本信息。
快速开始
注册与认证
1.注册起零API服务平台(https://api.istero.com)
2.登录控制台,右上角--获取API的TOKEN密钥即可
接口地址
https://api.istero.com/resource/collage/query
请求参数
请求头部 | 值 | 说明 | 示例 |
---|---|---|---|
Authorization | TOKEN | 用户中心获取到的TOKEN | 89defae676abd3e3a42b41df17c40096 |
名称 | 类型 | 必填 | 默认值 | 描述 | 示例 |
---|---|---|---|---|---|
token | string | 否 | 无 | 如传入Authorization,此参数可以忽略 | 89defae676abd3e3a42b41df17c40096 |
keyword | string | 是 | 无 | 关键词 | 杭州 |
GET请求实例
https://api.istero.com/resource/collage/query?token=TOKEN&keyword=%E5%8C%97%E4%BA%AC
响应数据
{
"code": 200,
"data": [
{
"name": "北京大学",
"location": "北京市",
"nature": "综合大学",
"type": "大学",
"is_985": true,
"is_211": true
},
{
"name": "北京交通大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京工业大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京航空航天大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": true,
"is_211": true
},
{
"name": "北京理工大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": true,
"is_211": true
},
{
"name": "北京科技大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京化工大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京工商大学",
"location": "北京市",
"nature": "财经院校",
"type": "大学",
"is_985": false,
"is_211": false
},
{
"name": "北京服装学院",
"location": "北京市",
"nature": "理工院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京邮电大学",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京印刷学院",
"location": "北京市",
"nature": "理工院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京建筑大学",
"location": "北京市",
"nature": "综合大学",
"type": "大学",
"is_985": false,
"is_211": false
},
{
"name": "北京石油化工学院",
"location": "北京市",
"nature": "理工院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京电子科技学院",
"location": "北京市",
"nature": "理工院校",
"type": "大学",
"is_985": false,
"is_211": false
},
{
"name": "北京农学院",
"location": "北京市",
"nature": "农业院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京林业大学",
"location": "北京市",
"nature": "林业院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京协和医学院(清华大学医学部)",
"location": "北京市",
"nature": "医药院校",
"type": "大学",
"is_985": true,
"is_211": true
},
{
"name": "北京中医药大学",
"location": "北京市",
"nature": "医药院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京师范大学",
"location": "北京市",
"nature": "师范院校",
"type": "大学",
"is_985": true,
"is_211": true
},
{
"name": "北京外国语大学",
"location": "北京市",
"nature": "语文院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京第二外国语学院",
"location": "北京市",
"nature": "语文院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京语言大学",
"location": "北京市",
"nature": "语文院校",
"type": "大学",
"is_985": false,
"is_211": false
},
{
"name": "北京物资学院",
"location": "北京市",
"nature": "财经院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京体育大学",
"location": "北京市",
"nature": "体育院校",
"type": "大学",
"is_985": false,
"is_211": true
},
{
"name": "北京电影学院",
"location": "北京市",
"nature": "艺术院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京舞蹈学院",
"location": "北京市",
"nature": "艺术院校",
"type": "学院",
"is_985": false,
"is_211": false
},
{
"name": "北京工业职业技术学院",
"location": "北京市",
"nature": "理工院校",
"type": "高职",
"is_985": false,
"is_211": false
},
{
"name": "北京信息职业技术学院",
"location": "北京市",
"nature": "理工院校",
"type": "高职",
"is_985": false,
"is_211": false
},
{
"name": "北京电子科技职业学院",
"location": "北京市",
"nature": "理工院校",
"type": "高职",
"is_985": false,
"is_211": false
},
{
"name": "北京科技大学延庆分校",
"location": "北京市",
"nature": "综合大学",
"type": "高专",
"is_985": false,
"is_211": false
}
],
"message": "未找到相关院校"
}
响应数据说明
名称 | 描述 | |
---|---|---|
code | 响应码 | |
data | name | 院校名称 |
location | 所在地 | |
nature | 学校性质 | |
type | 类型 | |
is_985 | 是否为985 | |
is_211 | 是否为211 | |
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不仅是一个简单的信息查询工具,更是连接教育资源与用户需求的重要桥梁。它通过提供标准化、结构化的院校数据,极大地便利了学生、家长、教育工作者以及相关机构的工作和生活。