| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 是 | 无 | 咕咕数据开发者中心分配的 APPKEY。 |
| year | string | 否 | 无 | 查询年份。当前可选值:2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。 |
| provinceName | string | 否 | 无 | 招生省份,可选值:上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。 |
application/json。| 字段 | 类型 | 说明 |
|---|---|---|
| DataStatus | object | 接口业务状态信息。 |
| DataStatus.StatusCode | integer | 咕咕数据业务状态码,100 表示业务处理成功。 |
| DataStatus.StatusDescription | string | 业务状态说明。 |
| DataStatus.ResponseDateTime | string | 接口响应时间。 |
| DataStatus.DataTotalCount | integer | 本次响应数据总数或分页总数。 |
| DataStatus.RequestParameter | 见响应定义 | 本次请求的参数摘要。 |
| Data | string | 接口返回的业务数据。 |
| 业务状态码 | 业务状态码解释 | 备注 |
|---|---|---|
| 100 | 正常返回 | |
| 101 | 参数错误 | |
| 102 | 请求频率受限 | 默认情况下,每个接口提供 5 QPS 并发能力,可满足大多数业务场景。超出当前并发能力时,网关可能返回 429 请求频率受限;如需更高吞吐,可按需购买额外 QPS 扩展包,高频调用场景支持白名单接入与独立流控策略。 |
| 103 | 账号欠费 | |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
| 110 | 接口响应错误 |