# 历年高考高校录取分数线
> 来源页面: https://www.gugudata.com/api/details/ceecollegeline
## 概览
- API 标识: `ceecollegeline`
- 分类: 教育/高考
- 描述: 高校历年录取分数与位次
- 标签: 高校全量数据 / 可按省或高校查询
- 短标签: 基础数据 / 高考
- 详情页: https://www.gugudata.com/api/details/ceecollegeline
- LLM Markdown: https://www.gugudata.com/api/details/ceecollegeline/llm.md
- 数据预览: https://www.gugudata.com/preview/ceecollegeline
- 购买开通: https://www.gugudata.com/order/ceecollegeline
- APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## 给大模型的接入指令
如果你正在帮助用户接入这个 API，请优先使用本文档中的接口地址、请求方式、请求参数、返回参数、状态码、cURL 示例和预览数据生成代码或排查问题。
- 接入目标: 调用 `历年高考高校录取分数线`，不要臆造未在文档中出现的参数或返回字段。
- AppKey 获取: 用户登录咕咕数据开发者中心后，在 `APP KEY 管理` 页面复制对应产品的 AppKey。
- AppKey 替换: 示例中的 `YOUR_APPKEY`、`APPKEY`、`{{YOUR_APPKEY}}`、`{{appkey}}`、`{{appKey}}` 都应替换为用户自己的 AppKey。
- AppKey 传递: 推荐使用 `X-GUGUDATA-APPKEY` 或 `X-API-Key` 请求头；OpenAI 兼容客户端可使用 `Authorization: Bearer <AppKey>`；历史 query 参数 `appkey` 继续有效。
- 开通与续费: 未开通时引导用户访问购买开通页；已开通或需要续费时，引导用户进入开发者中心或订单与续费页。
- 错误处理: HTTP 状态码代表传输层结果，响应体内的业务状态码代表接口业务结果，代码中应分别处理。
- 生产建议: AppKey 应保存在服务端环境变量或密钥配置中，由服务端统一发起请求，不要写入网页、App 客户端或公开仓库。
关键链接:
- 接口详情页: https://www.gugudata.com/api/details/ceecollegeline
- LLM Markdown: https://www.gugudata.com/api/details/ceecollegeline/llm.md
- 数据预览: https://www.gugudata.com/preview/ceecollegeline
- 购买开通页: https://www.gugudata.com/order/ceecollegeline
- 开发者中心 APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## API 功能
- 按招生省份或高校名称检索历年录取线；
- 可通过 SchoolUUID 精确定位高校；
- 支持年份、科类、批次和招生类型条件组合筛选；
- 区分考生招生省份与高校所在地，支持按学校所在省份筛选；
- 可按最低录取分数上限检索候选院校；
- 支持最低录取分数区间筛选；
- 返回最高分、平均分和最低分，展示对应录取记录的分数差异；
- 提供最低录取位次，辅助与考生位次对照；
- 返回省控制线，便于观察院校录取线与省级门槛的关系；
- 提供选科、招生类型及录取批次资料；
- 返回学校类型、所在城市及 985、211、双一流标识；
- 支持分页与多种排序，方便组织高校录取线列表；
- 毫秒级查询性能；
- 默认最大 QPS:5，可在开发者中心自助升级，年付订单接口调用次数不限。
- [接口调用状态与状态监控](https://www.gugudata.com/status)
## API 文档
- 接口地址: `https://api.gugudata.com/metadata/ceecollegeline`
- 返回格式: `application/json; charset=utf-8`
- 请求方式: `GET`
- 请求协议: `HTTPS`
- 请求示例: `https://api.gugudata.com/metadata/ceecollegeline?appkey=YOUR_APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0`
- 接口测试: https://api.gugudata.com/metadata/ceecollegeline/demo
- Apifox: https://doc.gugudata.com/
- Postman: https://www.postman.com/gugudata/gugudata-official
- OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
### 前置接口
#### 历年高考高校录取分数线-查询参数枚举
- 前置接口说明: 历年高考高校录取分数线-查询参数枚举
- 前置接口地址: https://api.gugudata.com/metadata/ceecollegeline/enums
- 前置接口参数说明: appkey=YOUR_APPKEY&year=2025&provinceName=上海
- 前置接口参数备注: year 与 provinceName 为必填参数。建议先查询枚举后，再调用主接口筛选。
- 前置接口返回格式: `application/json; charset=utf-8`
- 前置接口返回说明: 返回 type、batchName、enrollmentType、collegeProvinceName 的枚举集合
- 前置接口请求方式: `GET`
- 前置接口请求协议: `HTTPS`
## 鉴权方式
接口支持以下 AppKey 传递方式，任选一种即可；已有请求示例、Postman 集合和历史代码仍可继续使用原来的 `appkey` 参数方式。
| 传输载体 | 参数 | 示例 | 说明 |
| --- | --- | --- | --- |
| HTTP Header | `X-GUGUDATA-APPKEY` | `X-GUGUDATA-APPKEY: YOUR_APPKEY` | 推荐方式，适合服务端接入和统一封装。 |
| HTTP Header | `X-API-Key` | `X-API-Key: YOUR_APPKEY` | 通用 API Key Header，便于和常见 API 客户端集成。 |
| HTTP Header | `Authorization` | `Authorization: Bearer YOUR_APPKEY` | 适合 OpenAI 兼容接口或 Bearer Token 风格客户端。 |
| Query 参数 | `appkey` | `?appkey=YOUR_APPKEY` | 兼容现有示例、Postman 集合、浏览器调试和历史代码。 |
> 部分历史 POST 接口仍兼容表单或 JSON body 中的 `appkey`；新接入建议优先使用 Header 或 Query 参数。
## 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| appkey | string | 是 | 无 | 付费后获取的 APPKEY |
| searchtype | string | 是 | 无 | 查询条件类型，支持录取省份以及高校名称查询，参数值分别为：PROVINCENAME 或 COLLEGENAME |
| keyword | string | 是 | 无 | 录取省份或高校名称，高校名称支持模糊查询。searchtype=PROVINCENAME 时传招生省份；searchtype=COLLEGENAME 时传高校名称。招生省份当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
| pageindex | integer | 是 | 无 | 分页参数，第几页 |
| pagesize | integer | 是 | 无 | 分页参数，每页总条数，取值范围在 1 ~ 20 之间（含） |
| year | integer | 是 | 无 | 查询年份。当前可选值：2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| min | integer | 否 | 无 | 录取最低分查询条件，筛选出最低分小于等于查询条件的值 |
| type | string | 否 | 无 | 科类筛选。当前全部可选值（共 14 项）：综合、艺术类、体育类（历史）、体育类（物理）、历史类、物理类、艺术类（历史）、艺术类（物理）、文科、理科、体育类、蒙授文科、蒙授理科、艺术文。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举 （/metadata/ceecollegeline/enums）获取，使用返回字段 Data.type。 |
| keywordstrict | string | 否 | false | 控制 keyword 参数在查询高校名称时是否进行模糊查询，true 为精确匹配，默认值为 false 进行模糊查询 |
| enrollprovince | string | 否 | 无 | searchtype=COLLEGENAME 时附加招生省份筛选，例如江苏。当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
| batchname | string | 否 | 无 | 录取批次筛选，可使用英文逗号分隔传递多个值。当前全部可选值（共 74 项）：专科批、本科批、本科批（民委专项）、本科提前批、本科提前批A段、艺术类专科批、艺术类本科批、专科提前批、本科批A段、本科批B段、本科提前批B段、体育类本科批、体育类本科提前批、国家专项计划本科批、本科提前批C段、艺术类本科提前批、艺术类本科提前批B段、高校专项计划批次、提前一批本科、提前二批本科、本科一批、本科一批A1段、本科一批A段、本科一批B段、本科二批A段、本科二批B段、本科二批C段、高校专项计划批、高校专项计划本科批、本科二批、本科提前批C、专科提前批A段、提前批、零志愿批次、体育类专科批、平行录取一段、平行录取二段、普通类一段、普通类平行录取、普通类提前批、第二批第一段、第二批第二段、地方专项计划本科批、特殊类型招生批、专科批F段、本科批C段、专科特殊类型批次K段、本科一段、本科专项计划批、本科专项计划批E段、本科专项计划批次D段、本科专项计划批次E段、本科专项计划批次I段、本科二段、专项计划本科、本科提前二批、国家及地方专项、南疆单列、对口援疆计划本科一批、国家及地方专项、南疆单列、对口援疆计划本科一批次、国家及地方专项、南疆单列、对口援疆计划本科二批、国家及地方专项、南疆单列、对口援疆计划本科二批次、高职专科提前批、提前批A段、提前批B段、专科提前批B段、地方农村专项计划批次、综合评价批次、本科批（特殊类型）、特殊类型批、国家专项计划批、提前录取军校批、提前录取本科一批、提前录取本科二批、高职专科提前批E段、综合评价批。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举 （/metadata/ceecollegeline/enums）获取，使用返回字段 Data.batchName。 |
| collegeprovincename | string | 否 | 无 | 院校所在省份筛选，例如江苏。当前全部可选值（共 32 项）：上海、云南、北京、吉林、四川、天津、山东、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、福建、辽宁、重庆、陕西、香港、安徽、山西、新疆、甘肃、西藏、贵州、黑龙江、内蒙古、宁夏、青海。适用取值随年份 year 和招生省份 provinceName 变化。可选值请通过 历年高考高校录取分数线-查询参数枚举 （/metadata/ceecollegeline/enums）获取，使用返回字段 Data.collegeProvinceName。 |
| enrollmenttype | string | 否 | 无 | 招生类型筛选，例如普通类。示例：普通类、中外合作办学、国家专项计划、地方专项计划、高校专项计划、民族班、预科班、定向、少数民族、新疆内地班 等，完整见枚举接口（共约 1396 项，随年份与省份变化）。可选值请通过 历年高考高校录取分数线-查询参数枚举 （/metadata/ceecollegeline/enums）获取，使用返回字段 Data.enrollmentType。 |
| schooluuid | string | 否 | 无 | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息 、 历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 |
| sort | string | 否 | 无 | 排序控制，格式为 字段\|排序方向。未传 sort 时使用默认排序：min > 0 时按 LowestScore\|desc、Year\|desc；min 为空或 0 时按 Year\|desc；同分或同年记录按系统稳定顺序补位。排序方向可选 asc、desc：asc 表示升序（从小到大），desc 表示降序（从大到小）。多个排序条件用英文逗号分隔，并按传入顺序依次排序。支持字段：HighestScore（录取最高分，对应返回字段 HighestScore）、AverageScore（录取平均分，对应 AverageScore）、LowestScore（录取最低分，对应 LowestScore）、LowestRank（录取最低位次，对应 LowestRank）、ProvincialControlLine（省控线，对应 ProvincialControlLine）、EnrollmentType（招生类型，对应 EnrollmentType）、SelectionLevel（选测等级，对应 SelectionLevel，主要用于特定省份历史数据）。示例：LowestScore\|desc、LowestRank\|asc、HighestScore\|desc,LowestScore\|desc。 |
| minrange | string | 否 | 0 | 录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700 |
## 返回参数
| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| DataStatus.StatusCode | integer | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | integer | 此条件下的总数据量，一般用于分页计算 |
| DataStatus.RequestParameter | string | 请求参数，一般用于调试 |
| Data.Province | string | 该录取线面向的考生招生省份；与高校所在省份、城市区分使用。 |
| Data.SchoolUUID | string | 咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息 、 历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配 |
| Data.CollegeName | string | 高校名称 |
| Data.Year | integer | 招生年份 |
| Data.HighestScore | string | 录取最高分 |
| Data.AverageScore | string | 录取平均分 |
| Data.LowestScore | string | 对应年份、招生省份、科类、批次及招生类型下的最低录取分数，不是下一年度录取承诺。 |
| Data.LowestRank | string | 对应录取记录的最低位次，需在同省、同年、同科类口径下比较。 |
| Data.ProvincialControlLine | string | 该录取记录对应的省级批次控制线，不等同于院校最低录取分数。 |
| Data.EnrollmentType | string | 招生类型 |
| Data.SelectionLevel | string | 选测等级（特定省） |
| Data.AdmissionBatch | string | 录取批次筛选，可使用英文逗号分隔传递多个值。可选值请通过 历年高考高校录取分数线-查询参数枚举 （/metadata/ceecollegeline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。 |
| Data.TypeName | string | 科类筛选。可选值请通过 历年高考高校录取分数线-查询参数枚举 （/metadata/ceecollegeline/enums）获取，使用返回字段 Data.type。请按查询年份 year 和招生省份 provinceName 获取适用取值。 |
| Data.CourseSelection | string | 选科要求 |
| Data.CourseSelectionName | string | 专业组 |
| Data.SchoolType | string | 学校类型，如公办、民办 |
| Data.SchoolInCity | string | 高校所在地城市，不是考生所属招生地区。 |
| Data.Is985 | boolean | 是否为 985 院校 |
| Data.Is211 | boolean | 是否为 211 院校 |
| Data.IsDualClass | boolean | 是否为双一流院校 |
| Data.CoverImage | string | 高校 logo |
## 相关接口
### 历年高考高校录取分数线-查询参数枚举
- 请求方式: `GET`
- 资源路径: `/metadata/ceecollegeline/enums`
- 接口地址: `https://api.gugudata.com/metadata/ceecollegeline/enums`
- 描述: 返回 type、batchName、enrollmentType、collegeProvinceName 的枚举集合。
#### 请求参数
| 参数名 | 参数类型 | 是否必须 | 备注 |
| --- | --- | --- | --- |
| appkey | string | 是 | 付费后获取的 APPKEY。仅购买了对应主接口的 APPKEY 可调用。 |
| year | integer | 是 | 查询年份。当前可选值：2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| provinceName | string | 是 | 招生省份，可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
#### 请求示例
```json
{
"appkey": "YOUR_APPKEY",
"year": 2025,
"provinceName": "上海"
}
```
#### 响应示例
```json
{
"DataStatus": {
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-09-05 15:04:39.725",
"DataTotalCount": 213,
"RequestParameter": "year=2025&provinceName=江苏"
},
"Data": {
"type": [
"历史类",
"物理类",
"艺术类（历史）"
],
"batchName": [
"专科批",
"本科批",
"本科提前批",
"艺术类本科提前批",
"高校专项计划批"
],
"enrollmentType": [
"NIIT",
"中外合作",
"中外合作办学",
"乡村教师计划-南京市六合区",
"乡村教师计划-南京市浦口区",
"乡村教师计划-南通市启东市",
"乡村教师计划-南通市如东县",
"乡村教师计划-南通市如皋市",
"乡村教师计划-南通市海安市",
"乡村教师计划-南通市海门区",
"乡村教师计划-南通市通州区",
"乡村教师计划-宿迁市沭阳县",
"乡村教师计划-宿迁市泗洪县",
"乡村教师计划-宿迁市泗阳县",
"乡村教师计划-徐州市丰县",
"乡村教师计划-扬州市仪征市",
"乡村教师计划-扬州市宝应县",
"乡村教师计划-扬州市江都区",
"乡村教师计划-扬州市高邮市",
"乡村教师计划-泰州市兴化市",
"乡村教师计划-泰州市姜堰区",
"乡村教师计划-泰州市泰兴市",
"乡村教师计划-泰州市靖江市",
"乡村教师计划-淮安市涟水县",
"乡村教师计划-盐城市东台市",
"乡村教师计划-盐城市响水县",
"乡村教师计划-苏州市吴江区",
"乡村教师计划-苏州市太仓市",
"乡村教师计划-苏州市常熟市",
"乡村教师计划-苏州市张家港市",
"乡村教师计划-连云港市东海县",
"乡村教师计划-连云港市灌云县",
"乡村教师计划-连云港市赣榆区",
"乡村教师计划-镇江市丹徒区",
"乡村教师计划-镇江市丹阳市",
"乡村教师计划-镇江市句容市",
"乡村教师计划-镇江市扬中市",
"公安政法",
"军队",
"分段培养项目",
"分段培养项目（中外合作办学）",
"医学定向-南京市六合区",
"医学定向-南京市栖霞区",
"医学定向-南京市江宁区",
"医学定向-南京市浦口区",
"医学定向-南京市溧水区",
"医学定向-南通市如东县",
"医学定向-南通市如皋市",
"医学定向-南通市海安市",
"医学定向-南通市海门区",
"医学定向-南通市通州区",
"医学定向-宿迁市宿豫区",
"医学定向-宿迁市沭阳县",
"医学定向-宿迁市泗阳县",
"医学定向-常州市天宁区",
"医学定向-常州市新北区",
"医学定向-常州市武进区",
"医学定向-常州市溧阳市",
"医学定向-常州市金坛区",
"医学定向-常州市钟楼区",
"医学定向-徐州市丰县",
"医学定向-徐州市新沂市",
"医学定向-徐州市沛县",
"医学定向-徐州市睢宁县",
"医学定向-徐州市贾汪区",
"医学定向-徐州市邳州市",
"医学定向-徐州市铜山区",
"医学定向-扬州市仪征市",
"医学定向-扬州市宝应县",
"医学定向-扬州市广陵区",
"医学定向-扬州市江都区",
"医学定向-扬州市邗江区",
"医学定向-扬州市高邮市",
"医学定向-无锡市宜兴市",
"医学定向-无锡市江阴市",
"医学定向-泰州市兴化市",
"医学定向-泰州市姜堰区",
"医学定向-泰州市泰兴市",
"医学定向-泰州市泰州医药高新区（高港区）",
"医学定向-泰州市海陵区",
"医学定向-泰州市靖江市",
"医学定向-淮安市淮阴区",
"医学定向-盐城市东台市",
"医学定向-盐城市响水县",
"医学定向-盐城市大丰区",
"医学定向-盐城市滨海县",
"医学定向-盐城市盐都区",
"医学定向-苏州市吴中区",
"医学定向-苏州市吴江区",
"医学定向-苏州市太仓市",
"医学定向-苏州市常熟市",
"医学定向-苏州市张家港市",
"医学定向-苏州市相城区",
"医学定向-连云港市东海县",
"医学定向-连云港市海州区",
"医学定向-连云港市灌云县",
"医学定向-连云港市灌南县",
"医学定向-连云港市赣榆区",
"医学定向-连云港市连云区",
"医学定向-镇江市丹徒区",
"医学定向-镇江市丹阳市",
"医学定向-镇江市句容市",
"医学定向-镇江市扬中市",
"医学类",
"南京市六合区",
"南京市浦口区",
"南京校区",
"南京校区（中外合作办学）",
"南通市启东市",
"南通市如东县",
"南通市如皋市",
"南通市海安市",
"南通市海门区",
"地方专项计划",
"女生",
"威海校区（中外合作办学）",
"定向培养军士",
"宿迁市宿城区",
"宿迁市宿豫区",
"宿迁市沭阳县",
"宿迁市泗洪县",
"常州市武进区",
"常州市溧阳市",
"张家港校区",
"徐州市丰县",
"徐州市新沂市",
"徐州市沛县",
"徐州市贾汪区",
"徐州市邳州市",
"徐州市铜山区",
"扬州市广陵区",
"扬州市邗江区",
"扬州市高邮市",
"护理类",
"无锡市宜兴市",
"普洱校区",
"普通类",
"民航招飞",
"沙河校区",
"沙河校区（中外合作办学）",
"泰州市兴化市",
"泰州市泰兴市",
"泰州市靖江市",
"泰州校区",
"泰州校区（中外合作办学）",
"淮安市涟水县",
"淮安市金湖县",
"淮安校区",
"生长军官,女生",
"生长军官,男生",
"男生",
"盐城市东台市",
"盐城市响水县",
"盐城市大丰区",
"盐城市建湖县",
"盐城市滨海县",
"盐城市盐都区",
"综合评价",
"联合培养项目",
"航海",
"苏州市张家港市",
"边防军人子女预科班",
"连云港市东海县",
"连云港市灌云县",
"连云港市灌南县",
"连云港市赣榆区",
"连云港市连云区",
"镇江市丹徒区",
"镇江校区",
"镇江校区（中外合作办学）",
"马来西亚分校",
"高校专项计划",
"高校中外学分互认联合培养项目"
],
"collegeProvinceName": [
"上海",
"云南",
"内蒙古",
"北京",
"吉林",
"四川",
"天津",
"宁夏",
"安徽",
"山东",
"山西",
"广东",
"广西",
"新疆",
"江苏",
"江西",
"河北",
"河南",
"浙江",
"海南",
"湖北",
"湖南",
"甘肃",
"福建",
"西藏",
"贵州",
"辽宁",
"重庆",
"陕西",
"青海",
"香港",
"黑龙江"
]
}
}
```
## 接口常见 HTTP 响应状态码
> 以下为接口调用中常见的 HTTP 传输层状态码，不等同于响应体内的业务状态码；完整状态码注册表以 IANA HTTP Status Code Registry 为准。
| 状态码 | 状态码解释 | 备注 |
| --- | --- | --- |
| 200 | 请求成功 | HTTP 请求已成功处理；业务状态请结合响应体中的自定义业务码判断。 |
| 201 | 资源已创建 | 创建类接口请求成功，并已生成对应资源。 |
| 202 | 请求已接受 | 请求已被接受处理，结果可能异步完成。 |
| 204 | 无响应内容 | 请求成功但响应体为空，适用于无需返回数据的操作。 |
| 400 | 请求参数错误 | 请求参数缺失、格式错误或参数组合不合法。 |
| 401 | 认证失败 | 缺少、无效或未通过认证的访问凭证（如 AppKey）。 |
| 403 | 无权限访问 | 订单到期、权限不足或接口额度不可用。 |
| 404 | 资源不存在 | 请求路径不存在。 |
| 405 | 请求方法不允许 | 当前路径不支持该 HTTP 方法。 |
| 408 | 请求超时 | 客户端请求在服务端等待时间内未完成，可稍后重试。 |
| 409 | 请求冲突 | 请求与当前资源状态冲突，调整参数或业务状态后重试。 |
| 413 | 请求内容过大 | 上传文件或请求体超过接口限制。 |
| 414 | 请求地址过长 | 请求 URL 超过服务端可处理长度，建议减少查询参数或改用 POST。 |
| 415 | 请求内容类型不支持 | 上传或请求体的内容类型不符合接口要求。 |
| 422 | 请求语义错误 | 请求格式正确，但参数取值、语义或业务约束无法处理。 |
| 429 | 请求频率受限 | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |
| 431 | 请求头过大 | 请求头字段过大或过多，建议精简 Header 后重试。 |
| 500 | 服务器内部错误 | 服务端处理异常，请稍后重试。 |
| 502 | 服务暂时不可用 | 请稍后重试。 |
| 503 | 服务暂时不可用 | 请稍后重试。 |
| 504 | 请求超时 | 请稍后重试。 |
## 接口自定义业务状态码
| 业务状态码 | 业务状态码解释 | 备注 |
| --- | --- | --- |
| 100 | 正常返回 | |
| 101 | 参数错误 | |
| 102 | 请求频率受限 | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |
| 103 | 账号欠费 | |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
## cURL 请求示例
```bash
curl --location --request GET 'https://api.gugudata.com/metadata/ceecollegeline?appkey=YOUR_APPKEY&searchtype=&keyword=&pageindex=1&pagesize=10&year=&min=&type=&keywordstrict=false&enrollprovince=&batchname=&collegeprovincename=&enrollmenttype=&schooluuid=&sort=&minrange=0'
```
## 更多请求示例与预览数据
- [高校分数线：枚举参数（2026 上海）](https://www.gugudata.com/preview/69bad99d7f5e8071ced4a245)
- [高校分数线：复旦大学 2026 年上海严格匹配](https://www.gugudata.com/preview/69bad99c7f5e8071ced4a244)
- [高校分数线：按省份查询上海 2026 年录取线](https://www.gugudata.com/preview/69bad99c7f5e8071ced4a243)
- [高校分数线：同济大学 2026 年上海录取线](https://www.gugudata.com/preview/69bad99c7f5e8071ced4a242)
- [高校分数线：北京大学 2026 年上海录取线](https://www.gugudata.com/preview/69bad99c7f5e8071ced4a241)
- [2026 年中南大学在湖南的院校录取分数线（前十条）](https://www.gugudata.com/preview/6763da0b095da4a00b0d0a64)
## 常见问题 Q&A
### Q: 如何完成第一次 API 调用？
A: 先确认当前接口的请求方法、必填参数和成功状态，再使用对应产品的 AppKey 发起请求；以实际响应中的业务状态判断结果。 [查看接入指南](https://www.gugudata.com/developers/getting-started)
### Q: 如何保证请求时 AppKey 的安全性？
A: 在开发者中心的 APP KEY 管理页面复制对应产品的 AppKey，并保存在服务端环境变量或密钥管理服务中。不要写入网页、App 客户端、公开仓库或日志。
### Q: 接口可以用于哪些开发语言？
A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等支持 HTTP 请求的语言均可接入；也可以通过 OpenAPI、Postman 或 Apifox 查看和调试接口。
### Q: 请求失败或超时后可以重试吗？
A: 先区分 HTTP 状态与业务错误。参数、鉴权和权限错误应修正后再请求；超时并不表示服务端未执行，重试前需确认接口是否会重复计费或产生副作用。 [查看接入指南](https://www.gugudata.com/developers/errors-and-retries)
### Q: 接口的性能可以保证吗？
A: 实际响应时间受接口类型、参数和网络环境影响。请按当前套餐的 QPS 控制并发，生产接入前完成联调与容量评估。
### Q: 数据多久更新？
A: 不同接口按各自的数据周期更新，请以当前详情页的更新时间、更新频率及字段说明为准；不要将一次请求时间视为数据更新时间。
## 服务协议以及服务免责声明
- [服务协议](https://www.gugudata.com/license)
- [服务免责声明](https://www.gugudata.com/disclaimer)
## 技术支持
- 技术支持邮箱: support@gugudata.com
- 微信客服: https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7