职教高考控制线 API：招生类别枚举、筛选与空分数含义

GuGuData 职教高考及高职分类招生控制线 API 按年份、省份、招生类别、考生类型、批次和科类返回控制分数及备注。不同招生体系和考生群体的分数线不能直接混用，控制线也不等同于院校实际最低录取分数。

调用方式为 GET /metadata/vocational-control-lines，year 是必填正整数，没有默认年份。先按年份和招生省份获取枚举，再用招生类别、考生类型、批次与科类筛选控制线；Score=null 表示没有可用分数，不能显示为 0 分。

接口概览

项目	说明
请求方法	GET
接口地址	https://api.gugudata.com/metadata/vocational-control-lines
返回格式	JSON，UTF-8
调用凭据	对应产品 AppKey，示例使用 Header 传递

请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	无	无默认值；沿用 Query、Header、Bearer 鉴权，多处凭据须一致。
year	integer	是	无	必填正整数，范围 1–65535；实际覆盖以查询结果为准，没有默认年份。
provinceName	string	否	无	招生省份名称。 可选值及适用年份、省份以当前完整文档及对应枚举接口为准。
categoryCode	string	否	无	招生类别编码，为空时不按类别编码筛选。 可选值及适用年份、省份以当前完整文档及对应枚举接口为准。
category	string	否	无	招生类别筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举 （/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.category。请按查询年份 year 和招生省份 provinceName 获取适用取值。
studentType	string	否	无	考生类型筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举 （/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.studentType。请按查询年份 year 和招生省份 provinceName 获取适用取值。
scoreBatch	string	否	无	录取批次筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举 （/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.scoreBatch。请按查询年份 year 和招生省份 provinceName 获取适用取值。
subjectCategory	string	否	无	科类筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举 （/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.subjectCategory。请按查询年份 year 和招生省份 provinceName 获取适用取值。
pageIndex	integer	否	1	页码，默认 1；须为正整数。
pageSize	integer	否	10	每页条数，默认 10，范围 1–100。

枚举和数据覆盖可能随年份、招生省份及来源发布进度变化。列表中的示例值不代表所有条件组合都存在记录；不要把接口响应时间当作数据更新时间。

请求示例

下面是文档示例，不是已执行的真实测试结果。YOUR_APPKEY 为占位符；实际凭据保存在服务端，不写入网页、公开仓库或日志。中文参数使用 URL 编码；请求体示例使用 JSON。

curl --get 'https://api.gugudata.com/metadata/vocational-control-lines' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'year=2026' \
  --data-urlencode 'provinceName=广东' \
  --data-urlencode 'pageIndex=1' \
  --data-urlencode 'pageSize=10'

返回字段

参数名	参数类型	备注
DataStatus.RequestParameter	string	真实业务请求参数，中文可读，不包含凭据。
DataStatus.StatusCode	integer	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	筛选后匹配记录总数；合法越界页返回空数组。枚举接口为四项数组的元素总数。
Data.DataId	string	数据全局唯一 ID
Data.Year	integer	年份
Data.Province	string	省份名称
Data.Category	string	该记录所属的招生类别，需与考生类型、批次和科类一同理解。
Data.StudentType	string	考生类型
Data.ScoreBatch	string	录取批次
Data.SubjectCategory	string	科类名称
Data.Score	int?	该年份、省份、招生类别、考生类型、批次及科类下的控制分数；为 null 时表示未提供可用数值，不等同于 0 分。
Data.Remark	string	该条控制线的补充说明，可能包含分数以外的要求；无补充资料时为空字符串。

字段口径与使用边界

year 为必填正整数，没有默认年份；实际年份覆盖以查询结果为准。先使用 /metadata/vocational-control-lines/enums，按年份和省份取得 category、studentType、scoreBatch、subjectCategory 的可用值。Score 为 null 表示未提供可用分数，不等于零分。Remark 可能补充分数之外的要求，应与类别和批次一并展示。成功但空数组可能来自筛选组合或越界页，不能据此推断没有相关招生。

错误与结果核对

先检查 HTTP 状态，再检查 DataStatus.StatusCode；100 表示业务成功。参数、鉴权、订单权益、限流和服务异常应分别处理。不要把失败响应展示成“没有数据”，也不要因收到 HTTP 200 就直接读取业务结果。错误码和 QPS 以当前接口文档及套餐为准，不沿用旧文章中的统一频率承诺。

成功后继续核对匹配总数、实际列表、分页及返回字段。空值、空字符串和零值按各字段定义解释；无法确认的资料保留缺口，不填造招生代码、分数或政策条件。

接入时先选年份和招生省份，再从对应枚举取得筛选值；展示控制分数时保留招生类别、考生类型、批次、科类和备注。控制线不是院校最低录取线，空分数与空结果也要分别按字段定义和分页条件处理。

官方文档与预览

• 完整接口文档
• 公开数据预览
• 接口 Demo

本文由 GuGuData 产品方整理，接口契约核对日期为 2026 年 11 月 1 日。用于接口集成与资料核对；实际招生政策、选科与报考要求以适用年份的省级考试院和院校正式公告为准。