全国院校查询API集成指南

支付宝到账语音生成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帮助学生查找国外合作院校在中国境内的分校或合作项目，拓宽留学选择。