# 历年高校招生计划数据 API 数据接口


历年高校招生计划数据 API 数据接口

基础数据 / 高校招生，各高校历年招生计划数据，高校招生数据 / 历年计划。

![gugudata_api_cover](https://static.gugudata.com/api_college_enrollment_plan.png)

# 1. 产品功能

- 支持历年高校招生计划数据查询；
- 包含各高校招生计划详细数据；
- 多维度查询条件支持；
- 毫秒级查询性能；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- [接口调用状态与状态监控](https://www.gugudata.com/status)

# 2. API 文档

**接口详情:** [https://www.gugudata.com/api/details/collegeenrollmentplan](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://www.gugudata.com/preview/collegeenrollmentplan)

**接口测试:** [https://api.gugudata.com/metadata/college-enrollment-plan/demo](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  |               招生省份               |