[DEMO] 历年高考高校招生计划
GET
https://api.gugudata.com/metadata/college-enrollment-plan/demo
GET /metadata/college-enrollment-plan/demo业务说明
独立请求示例
{
"year": 2026,
"schoolname": "北京大学",
"provincename": "北京",
"pageIndex": 1,
"pageSize": 10
}返回契约
application/json{
"type": "object",
"properties": {
"Data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"DataId": {
"type": "string",
"nullable": true,
"description": "招生计划明细唯一标识。"
},
"InSchoolYears": {
"type": "string",
"nullable": true,
"description": "该招生专业的学制说明，按原文展示。"
},
"ClassOne": {
"type": "string",
"nullable": true,
"description": "专业门类/一级分类。"
},
"ClassTwo": {
"type": "string",
"nullable": true,
"description": "专业类/二级分类。"
},
"BatchName": {
"type": "string",
"nullable": true,
"description": "录取批次名称。"
},
"Type": {
"type": "string",
"nullable": true,
"description": "招生科类/选科类型。"
},
"SchoolName": {
"type": "string",
"nullable": true,
"description": "高校名称。"
},
"RecruitCode": {
"type": "string",
"nullable": true,
"description": "院校招生代码，按招生年份、省份、批次、科类及招生单元区分；同一高校可能有多个代码。空值表示当前未能确认对应代码。"
},
"EnrollmentNumbers": {
"type": "string",
"nullable": true,
"description": "该条招生计划的计划人数；按年份、招生省份、专业及批次等条件理解，不是实际录取人数。"
},
"SchoolUUID": {
"type": "string",
"nullable": true,
"description": "高校唯一标识。"
},
"CourseSelectionRequirements": {
"type": "string",
"nullable": true,
"description": "该招生计划的选科要求；空值表示尚未确认，不代表不限选科。"
},
"CollegeMajorName": {
"type": "string",
"nullable": true,
"description": "招生计划中的专业名称与说明。"
},
"ShortCollegeMajorName": {
"type": "string",
"nullable": true,
"description": "专业名称短名称。"
},
"CollegeMajorCode": {
"type": "string",
"nullable": true,
"description": "该招生专业对应的国标专业代码资料；与 LocalMajorCode 的本地报考代码区分使用。"
},
"LocalMajorCode": {
"type": "string",
"nullable": true,
"description": "对应招生目录中的本地专业代码（填报志愿使用），不等同于 CollegeMajorCode 国标专业代码。空值表示当前未能确认，不可用其他年份或国标代码代填。"
},
"Tuition": {
"type": "string",
"nullable": true,
"description": "该条计划的学费说明，通常按元／年计；遇到文字说明时保留原文，不视为空值或零学费。"
},
"Year": {
"type": "string",
"nullable": true,
"description": "招生年份。"
},
"ProvinceName": {
"type": "string",
"nullable": true,
"description": "招生计划面向的考生省份，不是高校所在地。"
},
"SpecialGroup": {
"type": "string",
"nullable": true,
"description": "适用专业组模式时返回的源数据组标识，不是填报志愿使用的专业组号。重庆返回空值；空值也可能表示未确认。"
},
"SpecialCode": {
"type": "string",
"nullable": true,
"description": "源数据中的专业标识，不可替代 LocalMajorCode 本地报考专业代码。"
},
"SpecialGroupName": {
"type": "string",
"nullable": true,
"description": "适用专业组模式时返回的专业组名称，例如（101）。重庆返回空值，选科要求请读取 CourseSelectionRequirements；空值不代表不限选科。"
},
"major_category": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "解析的专业分类结果。"
},
"included_majors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"code_candidate": {
"type": "string"
}
},
"required": [
"name",
"code_candidate"
],
"description": "解析出的包含专业列表。"
},
"description": "解析出的包含专业列表。"
},
"campus": {
"type": "string",
"nullable": true,
"description": "解析出的校区信息。"
},
"special_requirements": {
"type": "string",
"nullable": true,
"description": "解析出的特殊要求。"
}
},
"required": [
"DataId",
"InSchoolYears",
"ClassOne",
"ClassTwo",
"BatchName",
"Type",
"SchoolName",
"RecruitCode",
"EnrollmentNumbers",
"SchoolUUID",
"CourseSelectionRequirements",
"CollegeMajorName",
"ShortCollegeMajorName",
"CollegeMajorCode",
"LocalMajorCode",
"Tuition",
"Year",
"ProvinceName",
"SpecialGroup",
"SpecialCode",
"SpecialGroupName",
"major_category",
"included_majors",
"campus",
"special_requirements"
],
"description": "当前计划数组，嵌套类型详见 responseSchema。"
},
"description": "当前计划数组，嵌套类型详见 responseSchema。"
},
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "真实、可读的业务请求参数；无业务参数时为空，不包含凭据。"
},
"StatusCode": {
"type": "integer"
},
"StatusDescription": {
"type": "string"
},
"ResponseDateTime": {
"type": "string"
},
"DataTotalCount": {
"type": "integer",
"description": "主查询和招生代码查询为筛选后总记录数；枚举为各选项列表条数之和。"
}
}
}
},
"required": [
"Data",
"DataStatus"
]
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "真实、可读的业务请求参数；无业务参数时为空，不包含凭据。"
},
"StatusCode": {
"type": "integer"
},
"StatusDescription": {
"type": "string"
},
"ResponseDateTime": {
"type": "string"
},
"DataTotalCount": {
"type": "integer",
"description": "主查询和招生代码查询为筛选后总记录数；枚举为各选项列表条数之和。"
}
}
},
"Data": {
"type": "null",
"description": "当前计划数组，嵌套类型详见 responseSchema。"
}
}
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "真实、可读的业务请求参数；无业务参数时为空，不包含凭据。"
},
"StatusCode": {
"type": "integer"
},
"StatusDescription": {
"type": "string"
},
"ResponseDateTime": {
"type": "string"
},
"DataTotalCount": {
"type": "integer",
"description": "主查询和招生代码查询为筛选后总记录数；枚举为各选项列表条数之和。"
}
}
},
"Data": {
"type": "null",
"description": "当前计划数组，嵌套类型详见 responseSchema。"
}
}
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数错误 | HTTP 400 |
| 900 | 依赖失败 | HTTP 500 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
无
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-03 03:04:17