101_api_intro_metadata_collegeenrollmentplan
历年高校招生计划数据 API 数据接口
基础数据 / 高校招生，各高校历年招生计划数据，高校招生数据 / 历年计划。
1. 产品功能
- 支持历年高校招生计划数据查询；
- 包含各高校招生计划详细数据；
- 多维度查询条件支持；
- 毫秒级查询性能；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- 接口调用状态与状态监控
2. API 文档
接口详情: https://www.gugudata.com/api/details/collegeenrollmentplan
接口地址: https://api.gugudata.com/metadata/college-enrollment-plan
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/metadata/college-enrollment-plan?appkey={{YOUR_APPKEY}}&collegemajorname={{}}&year={{}}&pageIndex={{1}}&pageSize={{10}}&schoolname={{}}&provincename={{}}&classone={{}}&classtwo={{}}&batchname={{}}&type={{}}
数据预览: https://www.gugudata.com/preview/collegeenrollmentplan
接口测试: https://api.gugudata.com/metadata/college-enrollment-plan/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| collegemajorname | string | 否 | 查询的高校专业名称，支持模糊查询 | |
| year | int | 否 | 查询的招生年份，如 2020、2021、2022、2023。参数默认值为 0：即获取所有年份的招生计划数据 | |
| pageindex | int | 是 | 1 | 分页参数，第几页 |
| pagesize | int | 是 | 10 | 分页参数，每页总条数，取值范围在 10 ~ 100 之间（含） |
| schoolname | string | 否 | 查询的高校名称，支持模糊查询 | |
| provincename | string | 否 | 查询的招生省份 | |
| classone | string | 否 | 查询的专业大类 | |
| classtwo | string | 否 | 查询的专业小类 | |
| batchname | string | 否 | 录取批次参数，可选枚举值请参考 Data.AdmissionBatch 返回值枚举 | |
| type | string | 否 | 传递的参数值可选为：理科|文科|综合|艺术类|体育类|体育理|蒙授理科|艺术文|体育文|汉授美术|蒙授文科|学考文|学考理|艺术理|汉授音乐|汉授体育|其他艺术|汉授编导|蒙授音乐|蒙授体育|蒙授美术|旅游类|计算机类|3+证书|蒙授其他艺术|农学类|财会类|牧医类|蒙牧医类|美工设计类|汽驾类|幼师类|建筑类|烹饪类 |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量，一般用于分页计算 |
| Data.InSchoolYears | string | 学制年限 |
| Data.ClassOne | string | 专业大类 |
| Data.ClassTwo | string | 专业小类 |
| Data.BatchName | string | 录取批次 |
| Data.Type | string | 文理综合类别 |
| Data.SchoolName | string | 高校名称 |
| Data.EnrollmentNumbers | int | 招生人数 |
| Data.SchoolUUID | string | 咕咕数据平台高校唯一 ID |
| Data.CourseSelectionRequirements | string | 选科要求 |
| Data.CollegeMajorName | string | 高校专业名称 |
| Data.Year | int | 招生年份 |
| Data.ProvinceName | string | 招生省份 |
