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。
bash
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 以当前接口文档及套餐为准，不沿用旧文章中的统一频率承诺。
成功后继续核对匹配总数、实际列表、分页及返回字段。空值、空字符串和零值按各字段定义解释；无法确认的资料保留缺口，不填造招生代码、分数或政策条件。
接入时先选年份和招生省份，再从对应枚举取得筛选值；展示控制分数时保留招生类别、考生类型、批次、科类和备注。控制线不是院校最低录取线，空分数与空结果也要分别按字段定义和分页条件处理。
官方文档与预览
本文由 GuGuData 产品方整理，接口契约核对日期为 2026 年 11 月 1 日。用于接口集成与资料核对；实际招生政策、选科与报考要求以适用年份的省级考试院和院校正式公告为准。