[DEMO] 历年高考一分一段数据
GET
https://api.gugudata.com/metadata/ceeline/one-score-one-section/demo
GET /metadata/ceeline/one-score-one-section/demo业务说明
返回契约
application/json{
"oneOf": [
{
"type": "object",
"required": [
"DataStatus",
"Data"
],
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "array",
"items": {
"type": "object",
"required": [
"ExaminationScore",
"RankingRange",
"AdmissionBatchName",
"MinimumAdmissionScore",
"Ranking",
"ScoreType",
"SpecialCategory",
"LevelName",
"TypeName",
"CandidateCount",
"TotalCandidates",
"MinScore",
"MaxScore",
"HistoricalScores",
"HistoricalSameRankScores"
],
"properties": {
"ExaminationScore": {
"type": "string",
"description": "高考分数"
},
"RankingRange": {
"type": "string",
"description": "该分数段对应的位次范围；可能为区间文字，不应直接按单个整数解析。"
},
"AdmissionBatchName": {
"type": [
"string",
"null"
],
"description": "录取批次名称"
},
"MinimumAdmissionScore": {
"type": [
"string",
"null"
],
"description": "最低录取控制分数线"
},
"Ranking": {
"type": [
"string",
"null"
],
"description": "位次"
},
"ScoreType": {
"type": [
"string",
"null"
],
"description": "艺术成绩类型；普通类可能为 null。"
},
"SpecialCategory": {
"type": [
"string",
"null"
],
"description": "艺术专业类别，可能为空或 null。"
},
"LevelName": {
"type": [
"string",
"null"
],
"description": "来源层次名称，可能为空或 null。"
},
"TypeName": {
"type": [
"string",
"null"
],
"description": "沿用来源艺术类型说明，可能为空或 null；不保证可据此区分艺术查询中所有科类。"
},
"CandidateCount": {
"type": "integer",
"description": "该分数或分数段内的考生人数，与累计人数 TotalCandidates 区分。"
},
"TotalCandidates": {
"type": "integer",
"description": "截至该分数段的累计考生人数；应在同年份、同省份、同科类口径下对照。"
},
"MinScore": {
"type": "integer",
"description": "既有艺术类辅助整数边界；普通类或非整数边界保留原有 0 表达，不代表官方零分。"
},
"MaxScore": {
"type": "integer",
"description": "既有艺术类辅助整数边界，说明同 MinScore。"
},
"HistoricalScores": {
"type": "array",
"items": {
"type": "object",
"required": [
"AcademicYear",
"ExaminationScore",
"RankingRange"
],
"properties": {
"AcademicYear": {
"type": "integer",
"description": "历史资料年份。"
},
"ExaminationScore": {
"type": "string",
"description": "该年份的参考分值或区间文本。"
},
"RankingRange": {
"type": "string",
"description": "对应的历史来源位次区间。"
}
},
"additionalProperties": false,
"description": "历年同分段数据"
},
"description": "历年同分段数据"
},
"HistoricalSameRankScores": {
"type": "array",
"items": {
"type": "object",
"required": [
"AcademicYear",
"ExaminationScore",
"RankingRange"
],
"properties": {
"AcademicYear": {
"type": "integer",
"description": "历史资料年份。"
},
"ExaminationScore": {
"type": "string",
"description": "该年份的参考分值或区间文本。"
},
"RankingRange": {
"type": "string",
"description": "对应的历史来源位次区间。"
}
},
"additionalProperties": false,
"description": "历史同位次分数列表；以当前位次范围上界（无范围时使用 Ranking）在同省、同科类往年位次区间中匹配，返回命中的年份、分数段及位次范围。无匹配时为空数组，不代表该年份没有考生。"
},
"description": "历史同位次分数列表；以当前位次范围上界（无范围时使用 Ranking）在同省、同科类往年位次区间中匹配，返回命中的年份、分数段及位次范围。无匹配时为空数组，不代表该年份没有考生。"
}
},
"additionalProperties": false,
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
},
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
}
}
},
{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
}
}
}
]
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "按既有顺序返回的分数段对象数组；合法越界页为空数组。"
}
}
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数错误 | HTTP 200 |
| 900 | 依赖失败 | HTTP 500 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
无
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-09 03:49:36