96_api_intro_metadata_middleschool

40 阅读2分钟

全国中学基础信息 API 数据接口

基础数据,高校高考,提供全国初级高级中学基础数据,定时更新,多维度筛选。

gugudata_api_cover

1. 产品功能

  • 2024 年数据已更新;
  • 提供最新全国中学学校基本信息;
  • 包含全国初级中学与高等中学;
  • 总计近 10 万条全国中学精准数据;
  • 每月一次数据自动更新校正;
  • 包含学校各类属性信息;
  • 毫秒级响应性能;
  • 数据持续更新与维护;
  • 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
  • 全面兼容 Apple ATS;
  • 全国多节点 CDN 部署;
  • 接口极速响应,多台服务器构建 API 接口负载均衡;
  • 接口调用状态与状态监控

2. API 文档

接口详情: www.gugudata.com/api/details…

接口地址: api.gugudata.com/metadata/mi…

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: api.gugudata.com/metadata/mi…

数据预览: www.gugudata.com/preview/mid…

接口测试: api.gugudata.com/metadata/mi…

3. 请求参数

参数名参数类型是否必须默认值备注
appkeystringAPPKEY付费后获取的 APPKEY
pageindexint1页码,第几页数据
pagesizeint10每页数据量,参数最大值为 20
schooltypestringALL中学类型:ALL (不限制) | MIDDLE_SCHOOL (初级中学) | HIGH_SCHOOL (高级中学)
schoolnamestring学校名称,模糊搜索,参数默认值为空,不进行筛选
provincenamestring学校所在省份,参数默认值为空,不进行筛选
citynamestring学校所在城市,参数默认值为空,不进行筛选

4. 返回参数

参数名参数类型备注
RequestParameterstring接口请求参数
DataStatus.StatusCodeint接口返回状态码
DataStatus.StatusDescriptionstring接口返回状态说明
DataStatus.ResponseDateTimestring接口数据返回时间
DataStatus.DataTotalCountint此条件下的总数据量,一般用于分页计算
Data.Idstring数据全局唯一 ID,仅用于标识数据的唯一
Data.SchoolNamestring中学学校名称
Data.SchoolTypestring中学类型
Data.Provincestring学校所在省份
Data.Citystring学校所在城市
Data.Districtstring学校所在区县
Data.Addressstring学校地址
Data.PostalCodestring学校邮政编码
Data.PhoneCodestring学校电话区号