歷年高考專業(yè)錄取分?jǐn)?shù)線 API 接口
高校專業(yè)各省錄取分?jǐn)?shù)線蕴侧，多種查詢條件懈糯，百萬級數(shù)據(jù)。
1. 產(chǎn)品功能
全國高校各專業(yè)在全國各省的詳細錄取數(shù)據(jù)，從 2015 年至 2021 年瑰剃；
三百萬已校對歷史數(shù)據(jù)；
多種查詢條件便于多維度分析筝野；
返回數(shù)據(jù)包含該專業(yè)錄取的最低分晌姚、最高分、平均分歇竟、最低位次等信息挥唠；
數(shù)據(jù)持續(xù)更新與維護；
全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）焕议；
全面兼容 Apple ATS宝磨；
全國多節(jié)點 CDN 部署；
接口極速響應(yīng)盅安，多臺服務(wù)器構(gòu)建 API 接口負(fù)載均衡唤锉；
2. API 文檔
API 詳情地址: https://www.gugudata.com/api/details/ceemajorline
接口地址: hhttps://api.gugudata.com/metadata/ceemajorline
返回格式: application/json; charset=utf-8
請求方式: GET
請求協(xié)議: HTTPS
數(shù)據(jù)預(yù)覽: https://www.gugudata.com/preview/ceemajorline
接口測試: https://api.gugudata.com/metadata/ceemajorline/demo
3. 請求參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 是否必須 | 默認(rèn)值 | 備注 | ||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付費后獲取的 APPKEY | ||||||||||||||||||||||||||||||||||||||||||
| pageindex | int | 是 | 1 | 分頁參數(shù)，第幾頁 | ||||||||||||||||||||||||||||||||||||||||||
| pagesize | int | 是 | 10 | 分頁參數(shù)别瞭，每頁總條數(shù)窿祥，取值范圍在 10 ~ 50 之間 | ||||||||||||||||||||||||||||||||||||||||||
| enrollprovince | string | 否 | 招生省份的條件，如查詢北京大學(xué)計算機科學(xué)與技術(shù)專業(yè)在江蘇的錄取數(shù)據(jù)蝙寨，那么該值傳遞 “江蘇” 即可晒衩。(enrollprovince嗤瞎、schoolname、majorname 三個參數(shù)都不是必選參數(shù)浸遗，但不可同時為空) | |||||||||||||||||||||||||||||||||||||||||||
| schoolname | string | 否 | 高校名稱猫胁。(enrollprovince、schoolname跛锌、majorname 三個參數(shù)都不是必選參數(shù)弃秆，但不可同時為空) | |||||||||||||||||||||||||||||||||||||||||||
| majorname | string | 否 | 專業(yè)名稱，如電氣工程與智能控制髓帽、計算機科學(xué)與技術(shù)等菠赚，此參數(shù)支持模糊搜索。(enrollprovince郑藏、schoolname衡查、majorname 三個參數(shù)都不是必選參數(shù)，但不可同時為空) | |||||||||||||||||||||||||||||||||||||||||||
| year | int | 否 | 0 | 查詢的錄取年份必盖，如 2019拌牲、2020、2021歌粥。參數(shù)默認(rèn)值為 0：即獲取所有年份的錄取數(shù)據(jù) | ||||||||||||||||||||||||||||||||||||||||||
| min | int | 否 | 0 | 錄取最低分查詢條件塌忽，篩選出最低分小于等于查詢條件的值。默認(rèn)值為 0失驶，不進行篩選 | ||||||||||||||||||||||||||||||||||||||||||
| batchname | string | 否 | 專業(yè)所屬的錄取批次土居，傳遞參數(shù)可選值為：本科二批 | 專科批 | 本科一批 | 本科批 | 本科三批 | 本科二批A段 | 本科一批A段 | 平行錄取二段 | 平行錄取一段 | 本科提前批 | 平行錄取三段 | 普通類一段 | 本科批A段 | 本科二批C段 | 本科一批B段 | 本科二批B段 | 本科三批A段 | 本科二批及預(yù)科 | 普通類二段 | 屾姨剑科批A段 | 本科批B段 | 國家專項計劃本科批 | 本科提前批A段 | 尣烈科提前批 | 地方專項計劃本科批 | 本科提前批B段 | 分類招生批 | 提前批 | 本科一批A1段 | 本科一段 | 高校專項計劃本科批 | 本科A批 | 普通類提前批 | 本科二段 | 零志愿批次 | 零批次 | 無批次 | 國家專項計劃本科一批 | 本科二批K段 | |||||
| typename | string | 否 | 專業(yè)所屬的類型，傳遞參數(shù)可選值為：理科 | 文科 | 綜合 | 藝術(shù)類 | 藝術(shù)文 | 體育類 | 藝術(shù)理 | 學(xué)考理 | 體育理 | 學(xué)考文 | 蒙授文科 | 蒙授理科 | 3+證書 | 體育文 | 計算機類 | 會計類 | 土建類 | 旅游類 | 護理類 | 電子技術(shù)類 | 農(nóng)學(xué)類 | 汽車類 | 幼師類 | 美工設(shè)計類 | 機械加工類 | 電子商務(wù)類 | 財會類 | 漢授美術(shù) | 電氣技術(shù)類 | 畜牧獸醫(yī)類 | 藥劑類 | 農(nóng)林類 | 牧醫(yī)類 | 汽駕類 | 服裝設(shè)計與工藝類 | 蒙牧醫(yī)類 | 其他藝術(shù) | 漢授音樂 | 建筑類 | 烹飪類 | 醫(yī)學(xué)類 | 教育類 | 園林類 |
4. 返回參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 備注 | |
|---|---|---|---|
| DataStatus.StatusCode | int | 接口返回狀態(tài)碼 | |
| DataStatus.StatusDescription | string | 接口返回狀態(tài)說明 | |
| DataStatus.ResponseDateTime | string | 接口數(shù)據(jù)返回時間 | |
| DataStatus.DataTotalCount | int | 此條件下的總數(shù)據(jù)量涩堤，一般用于分頁計算 | |
| DataStatus.RequestParameter | string | 請求參數(shù)眷蜓，一般用于調(diào)試 | |
| Data.ProvinceName | string | 招生的省份 | |
| Data.SchoolUUID | string | 咕咕數(shù)據(jù)平臺高校唯一 ID，此唯一 ID 可與 全國大學(xué)高卸铮基礎(chǔ)信息账磺、歷年高考高校錄取分?jǐn)?shù)線 接口中的 SchoolUUID 進行唯一匹配 | |
| Data.SchoolName | string | 高校名稱 | |
| Data.MajorName | string | 專業(yè)名稱 | |
| Data.Year | int | 招生年份 | |
| Data.HighSocre | int | string | 錄取最高分，沒有值時返回 '-' |
| Data.AverageScore | int | string | 錄取平均分痊远，沒有值時返回 '-' |
| Data.LowestScore | int | 錄取最低分 | |
| Data.LowestSection | int | string | 錄取最低位次，沒有值時返回 '-' |
| Data.BatchName | string | 錄取批次氏捞，如本科二批碧聪、專科批液茎、本科一批等 | |
| Data.TypeName | string | 專業(yè)所屬的類型逞姿，如理科辞嗡、文科、綜合滞造、藝術(shù)類等 | |
| Data.ProScore | int | string | 專業(yè)分续室，部分高校專業(yè)錄取有此值，沒有值時返回 '-' |
5. 接口 HTTP 響應(yīng)標(biāo)準(zhǔn)狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 200 | 接口正常響應(yīng) | 業(yè)務(wù)狀態(tài)碼參見下方 接口自定義狀態(tài)碼 |
| 403 | 請求頻率超限 | CDN 層通過 IP 請求頻率智能判斷谒养，一般的高頻請求不會觸發(fā)此狀態(tài)碼 |
6. 接口響應(yīng)狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 100 | 正常返回 | 可通過判斷此狀態(tài)碼斷言接口正常返回 |
| -1 | 請求失敗 | 請求處理請求失敗 |
| 501 | 參數(shù)錯誤 | 請檢查您傳遞的參數(shù)個數(shù)以及參數(shù)類型是否匹配 |
| 502 | 請求頻率受限 | 一般建議每秒請求不超過 100 次 |
| 503 | APPKEY 權(quán)限超限/訂單到期 | 請至開發(fā)者中心檢查您的 APPKEY 是否到期或是否權(quán)限超限 |
| 504 | APPKEY 錯誤 | 請檢查傳遞的 APPKEY 是否為開發(fā)者中心獲取到的值 |
| 505 | 請求的次數(shù)超出接口限制 | 請檢查對應(yīng)接口是否有請求次數(shù)限制以及您目前的接口請求剩余次數(shù) |
| 900 | 接口內(nèi)部響應(yīng)錯誤 | 接口可用性為 99.999%挺狰，如獲取到此狀態(tài)碼請郵件聯(lián)系我們 |
7. 開發(fā)語言請求示例代碼
示例代碼包含的開發(fā)語言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他語言進行對應(yīng)的 RESTful API 請求實現(xiàn)即可买窟。
8. 常見問題 Q&A
-
Q: 數(shù)據(jù)請求有緩存嗎丰泊？
A: 所有的數(shù)據(jù)都是直接返回的，部分周期性數(shù)據(jù)在更新周期內(nèi)數(shù)據(jù)是緩存的始绍。
-
Q: 如何保證請求時 key 的安全性瞳购？
A: 一般建議將對我們 API 的請求放置在您應(yīng)用的后端服務(wù)中發(fā)起，您應(yīng)用的所有前端請求都應(yīng)該指向您自己的后端服務(wù)亏推，這樣的架構(gòu)也更加地純粹且易維護学赛。
-
Q: 接口可以用于哪些開發(fā)語言？
A: 可以使用于所有可以進行網(wǎng)絡(luò)請求的開發(fā)語言吞杭，用于您項目快速地進行數(shù)據(jù)構(gòu)建盏浇。
-
Q: 接口的性能可以保證嗎？
A: 接口后臺架構(gòu)和我們給企業(yè)提供的商業(yè)項目架構(gòu)一致篇亭，您可以通過訪問測試接口查看接口相關(guān)返回性能與信息缠捌。
咕咕數(shù)據(jù)，專業(yè)的數(shù)據(jù)提供商译蒂，提供專業(yè)全面的數(shù)據(jù)接口曼月、商業(yè)數(shù)據(jù)分析，讓數(shù)據(jù)成為您的生產(chǎn)原料柔昼。
咕咕數(shù)據(jù)基于我們七年來為企業(yè)客戶提供的千億級數(shù)據(jù)存儲與性能優(yōu)化哑芹、相關(guān)海量基礎(chǔ)數(shù)據(jù)支撐，將合規(guī)的部分通用數(shù)據(jù)捕透、通用功能抽象成產(chǎn)品級數(shù)據(jù) API聪姿，大大滿足了用戶在產(chǎn)品開發(fā)過程中對基礎(chǔ)數(shù)據(jù)的需求，同時降低了海量數(shù)據(jù)的存儲與運維成本乙嘀，以及復(fù)雜功能的技術(shù)門檻與人力開發(fā)成本末购。
除了我們已開放的分類數(shù)據(jù)與功能接口外，還有海量數(shù)據(jù)正在整理虎谢、清洗盟榴、整合、構(gòu)建中婴噩，后期會開放更多的數(shù)據(jù)與云端功能接口 API 供用戶使用擎场。
