歷年高考省錄取分數(shù)線 API 接口
提供近 10 年高考各批次錄取分數(shù)線。
1. 產(chǎn)品功能
2014年 - 2021年全國各省數(shù)據(jù)；
完整錄取批次數(shù)據(jù)；
多種搜索參數(shù)滿足各類數(shù)據(jù)請求需求；
數(shù)據(jù)持續(xù)更新；
全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
全面兼容 Apple ATS；
全國多節(jié)點 CDN 部署；
接口極速響應，多臺服務器構建 API 接口負載均衡；
2. API 文檔
API 詳情地址: https://www.gugudata.com/api/details/ceeprovince
接口請求地址: https://api.gugudata.com/metadata/ceeprovince
返回格式: application/json; charset=utf-8
請求方式: GET
請求協(xié)議: HTTPS
請求示例: https://api.gugudata.com/metadata/ceeprovince?appkey=YOUR_APPKEY&keyword=YOUR_VALUE
接口測試: https://api.gugudata.com/metadata/ceeprovince/demo
3. 請求參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 是否必須 | 默認值 | 備注 | ||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付費后獲取的 APPKEY | ||||||||||||||||||||||||||||||||||||||
| keyword | string | 否 | YOUR_VALUE | 省份搜索關鍵字，如江蘇，為空返回所有數(shù)據(jù) | ||||||||||||||||||||||||||||||||||||||
| year | int | 否 | 錄取數(shù)據(jù)的年份 | |||||||||||||||||||||||||||||||||||||||
| category | string | 否 | 綜合、文科理科等，可選枚舉值為：文科 | 理科 | 綜合 | 體育類 | 藝術類 | 藝術文 | 藝術理 | 體育理 | 體育文 | 蒙授文科 | 蒙授理科 | 學考文 | 醫(yī)學類 | 學考理 | 漢授音樂 | 計算機類 | 牧醫(yī)類 | 蒙授體育 | 汽駕類 | 旅游類 | 美工設計類 | 采礦類 | 幼師類 | 蒙授其他藝術 | 農(nóng)學類 | 化工類 | 漢授美術 | 蒙牧醫(yī)類 | 機電類 | 建筑類 | 財會類 | 漢授體育 | 漢授其他藝術 | 漢授編導 | 蒙授音樂 | 蒙授美術 | 畜牧獸醫(yī)類 | 農(nóng)林類 | 烹飪類 |
4. 返回參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 備注 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DataStatus.StatusCode | int | 接口返回狀態(tài)碼 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DataStatus.StatusDescription | string | 接口返回狀態(tài)說明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DataStatus.ResponseDateTime | string | 接口數(shù)據(jù)返回時間 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DataStatus.DataTotalCount | int | 此條件下的總數(shù)據(jù)量，一般用于分頁計算 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data.Province | string | 省份 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data.Category | string | 文理科或綜合等，枚舉值為：文科 | 理科 | 綜合 | 體育類 | 藝術類 | 藝術文 | 藝術理 | 體育理 | 體育文 | 蒙授文科 | 蒙授理科 | 學考文 | 醫(yī)學類 | 學考理 | 漢授音樂 | 計算機類 | 牧醫(yī)類 | 蒙授體育 | 汽駕類 | 旅游類 | 美工設計類 | 采礦類 | 幼師類 | 蒙授其他藝術 | 農(nóng)學類 | 化工類 | 漢授美術 | 蒙牧醫(yī)類 | 機電類 | 建筑類 | 財會類 | 漢授體育 | 漢授其他藝術 | 漢授編導 | 蒙授音樂 | 蒙授美術 | 畜牧獸醫(yī)類 | 農(nóng)林類 | 烹飪類 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data.ScoreBatch | string | 錄取批次，枚舉值為：本科二批 | 本科一批 | 專科批 | 本科三批 | 本科批 | ?？埔慌?/td> | 體育類（本科） | 藝術類（高職專科） | 體育類（高職專科） | 藝術類（本科） | 特殊類型招生控制線 | 體育類（本科一批） | 體育類（本科二批） | 本科二批C段 | ?？婆í毩W院、民辦、省屬高職除武漢） | ?？铺崆芭?/td> | ?？贫?/td> | 自招線 | 藝術類（本科一批） | 藝術類（本科二批） | ?？婆ㄉ贁?shù)民族） | ?？婆h族） | 藝術A類（本科） | 藝術B類（本科） | 高水平運動隊 | 國家專項計劃本科一批 | 國家專項計劃本科二批 | 地方專項計劃本科一批 | 平行錄取二段 | 平行錄取一段 | 本科批（漢族） | 本科提前批 | 特殊類型錄取控制線（強基計劃等） | 普通本科（漢族） | 本科一段 | 平行錄取三段 | 重點本科（少數(shù)民族） | 普通本科（少數(shù)民族） | 本科批（少數(shù)民族） | 體育類（?？疲?/td> | 軍校軍檢線 | 地方專項計劃批 | 預科班 | 藝術類（本科批） | 國家專項計劃批 | 重點本科（漢族） | 本科二段 | 體育類（本科批） | 體育類（平行錄取一段） | 體育類（平行錄取二段） | 藝術類（高職專科）(?？急究苹驅？坪细? | 藝術類（本科批）(舞蹈類) | 省內院校本科民族預科 | 體育類一段（含專業(yè)成績） | 高分優(yōu)先投檔批 | 體育類二段（含專業(yè)成績） | 蒙授本科一批 | 蒙授本科二批 | 地方專項計劃本科批 | 普通類一段 | 蒙授高職高專 | 體育類（本、專科） | 重點本科批 | 體育類（本科三批） | 體育類本科文化控制分數(shù)線 | 藝術類本科文化控制分數(shù)線 | 本科批A段 | 藝術類（高職?？疲?播音與主持類) | 本科批B段 | 藝術類（?？疲?/td> | 普通類二段 | 普通本科批（少） | 高分優(yōu)先投檔線 | 部隊生源招生本科控制線 | 體育類本科批（少） | 普通本科批 | 藝術類本科批（漢） | 體育類本科批（漢） | 重點本科批（少） | 藝術類本科批（少） | 藝術類（高職?？疲?攝影攝像類) | 省內專項 | 民族班及預科 | 國家貧困地區(qū)專項計劃批 | 貧困地區(qū)專項計劃（本科一批） | 貧困地區(qū)專項計劃（本科二批） | 省外院校民族班、民族預科（本科一批） | 藝術類（本科批）(書法藝術與書法教育類) | 省外院校民族班、民族預科（本科二批） | 省內專項（本科一批） | 省內專項（本科二批） | 藝術類（本科）(?？急究坪细? | 藝術類（高職?？疲?美術類) | 藝術類（高職?？疲?書法藝術與書法教育類) | 藝術C類（本科） | 藝術類（高職專科）(編導類) | 藝術類（高職?？疲?表演類（戲劇表演）) | 藝術類（高職專科）(表演類（服裝表演）) | 藝術類（高職?？疲?舞蹈類) | 藝術類（高職專科）(音樂類) | 藝術類（本科批）(攝影攝像類) | 藝術類（本科批）(播音與主持類) | 藝術類（本科批）(編導類) | 藝術類（本科批）(表演類（戲劇表演）) | 藝術類（本科批）(表演類（服裝表演）) | 藝術類（本科批）(美術類) | 藝術類（本科批）(音樂類) | 特殊類型資格線 | 藝術類（本科）(航空服務藝術與管理) | 藝術類（本科）(書法學) | 藝術類（本科）(舞蹈) | 藝術類（本科）(音樂表演) | 藝術類（本科）(美術設計) | 藝術類（本科）(播音編導) | 藝術類（本科提前批）(舞蹈學類) | 地方專項計劃本科二批 | 藝術類（本科提前批）(美術與設計學類、音樂學類、戲劇與影視學類) | 藝術類（?？铺崆芭?/td> | 本科二批(舞蹈) | ?？婆?足球排球籃球類) | 本科一批(播音與主持藝術) | ?？婆?美術) | 藝術類（平行錄取二段）(音樂類) | 本科一批(廣播電視編導) | 本科二批(聲樂) | 體育類高職（?？疲┪幕刂品謹?shù)線 | 藝術類高職（?？疲┪幕刂品謹?shù)線 | ?？婆?書法) | 藝術類（平行錄取一段）(編導類) | ?？婆?體操武術類) | 藝術類本科批 | ?？婆?器樂) | 本科一批(體操武術類) | ?？婆?聲樂) | ?？婆?播音與主持藝術) | 藝術類（本科）(戲劇與影視學類) | 藝術類（本科）(不含戲劇與影視學類) | 藝術類（平行錄取二段）(攝制類) | 藝術類（平行錄取二段）(編導類) | 藝術類（平行錄取二段）(播音主持類) | 藝術類（平行錄取二段）(時裝表演類) | 藝術類（平行錄取二段）(影視表演類) | 藝術類（平行錄取二段）(舞蹈類) | 藝術類（平行錄取二段）(美術類) | 藝術類（平行錄取一段）(攝制類) | 藝術類（平行錄取一段）(播音主持類) | 藝術類（平行錄取一段）(時裝表演類) | 藝術類（平行錄取一段）(影視表演類) | 藝術類（平行錄取一段）(舞蹈類) | 本科一批(聲樂) | 藝術類（平行錄取一段）(音樂類) | 藝術類（平行錄取一段）(美術類) | 本科一批(唐卡) | 藝術類（本科）(舞蹈類、影視戲劇表演類、服裝表演類) | 藝術類（本科）(美術類、音樂類、書法類、航空服務藝術類) | 藝術類（本科）(文學編導類、播音主持類、攝影類) | 本科一批(航空服務藝術與管理) | 本科一批(舞蹈) | 本科一批(作曲) | 本科一批(器樂) | 本科一批(書法) | 本科一批(美術) | 本科二批(航空服務藝術與管理) | 本科二批(播音與主持藝術) | 本科二批(廣播電視編導) | 本科二批(器樂) | 本科二批(書法) | 本科二批(美術) | ?？婆?航空服務藝術與管理) | 專科批(舞蹈) | ?？婆?廣播電視編導) | 本科一批(足球排球籃球類) | 本科一批(田徑類) | 本科二批(體操武術類) | 本科二批(足球排球籃球類) | 本科二批(田徑類) | ?？婆?田徑類) |
| Data.Year | int | 年份，2014年 - 2021年 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data.Score | int | 分數(shù)線 |
5. 接口 HTTP 響應標準狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 200 | 接口正常響應 | 業(yè)務狀態(tài)碼參見下方 接口自定義狀態(tài)碼 |
| 403 | 請求頻率超限 | CDN 層通過 IP 請求頻率智能判斷，一般的高頻請求不會觸發(fā)此狀態(tài)碼 |
6. 接口響應狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 100 | 正常返回 | 可通過判斷此狀態(tài)碼斷言接口正常返回 |
| -1 | 請求失敗 | 請求處理請求失敗 |
| 501 | 參數(shù)錯誤 | 請檢查您傳遞的參數(shù)個數(shù)以及參數(shù)類型是否匹配 |
| 502 | 請求頻率受限 | 一般建議每秒請求不超過 100 次 |
| 503 | APPKEY 權限超限/訂單到期 | 請至開發(fā)者中心檢查您的 APPKEY 是否到期或是否權限超限 |
| 504 | APPKEY 錯誤 | 請檢查傳遞的 APPKEY 是否為開發(fā)者中心獲取到的值 |
| 505 | 請求的次數(shù)超出接口限制 | 請檢查對應接口是否有請求次數(shù)限制以及您目前的接口請求剩余次數(shù) |
| 900 | 接口內部響應錯誤 | 接口可用性為 99.999%，如獲取到此狀態(tài)碼請郵件聯(lián)系我們 |
7. 開發(fā)語言請求示例代碼
示例代碼包含的開發(fā)語言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他語言進行對應的 RESTful API 請求實現(xiàn)即可。
8. 常見問題 Q&A
-
Q: 數(shù)據(jù)請求有緩存嗎？
A: 所有的數(shù)據(jù)都是直接返回的，部分周期性數(shù)據(jù)在更新周期內數(shù)據(jù)是緩存的。
-
Q: 如何保證請求時 key 的安全性？
A: 一般建議將對我們 API 的請求放置在您應用的后端服務中發(fā)起，您應用的所有前端請求都應該指向您自己的后端服務，這樣的架構也更加地純粹且易維護。
-
Q: 接口可以用于哪些開發(fā)語言？
A: 可以使用于所有可以進行網(wǎng)絡請求的開發(fā)語言，用于您項目快速地進行數(shù)據(jù)構建。
-
Q: 接口的性能可以保證嗎？
A: 接口后臺架構和我們給企業(yè)提供的商業(yè)項目架構一致，您可以通過訪問測試接口查看接口相關返回性能與信息。
咕咕數(shù)據(jù)，專業(yè)的數(shù)據(jù)提供商，提供專業(yè)全面的數(shù)據(jù)接口、商業(yè)數(shù)據(jù)分析，讓數(shù)據(jù)成為您的生產(chǎn)原料。
咕咕數(shù)據(jù)基于我們七年來為企業(yè)客戶提供的千億級數(shù)據(jù)存儲與性能優(yōu)化、相關海量基礎數(shù)據(jù)支撐，將合規(guī)的部分通用數(shù)據(jù)、通用功能抽象成產(chǎn)品級數(shù)據(jù) API，大大滿足了用戶在產(chǎn)品開發(fā)過程中對基礎數(shù)據(jù)的需求，同時降低了海量數(shù)據(jù)的存儲與運維成本，以及復雜功能的技術門檻與人力開發(fā)成本。
除了我們已開放的分類數(shù)據(jù)與功能接口外，還有海量數(shù)據(jù)正在整理、清洗、整合、構建中，后期會開放更多的數(shù)據(jù)與云端功能接口 API 供用戶使用。
