全国高校查询API【Pro版】集成指南

引言

在当今信息化迅速发展的时代，教育领域也不例外地迎来了数字化转型的浪潮。随着高考制度的不断改革和完善，考生和家长对于院校信息的需求也日益增长。通过此API可以了解全国相关高校的基本信息。

快速开始

注册与认证

1.注册起零数据平台（https://api.istero.com）
2.登录控制台，右上角--获取API的TOKEN密钥即可

接口地址

https://api.istero.com/resource/v1/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请求实例

https://api.istero.com/resource/v1/school/query/plus?token=TOKEN&name=杭州

响应数据

{
  "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	数据返回成功
202	余额不足，仅付费接口会出现此状态码
302	接口维护/停止服务
400	请求失败，“message”显示错误信息
403	TOKEN鉴权失败
404	接口不存在
429	超出会籍QPS限制
500	接口服务器错误
502	账号被封锁/冻结

案例应用场景

第三方教育服务平台

各类第三方教育服务平台，如在线课程提供商、留学中介等，也可以通过集成全国院校查询API来增强其服务内容。例如，一家在线课程平台可以在用户注册时，根据用户的地理位置和学习目标，推荐相关的院校及其开设的相关课程；或者一家留学中介机构可以使用API帮助学生查找国外合作院校在中国境内的分校或合作项目，拓宽留学选择。