全國大學(xué)高谐言梗基礎(chǔ)信息 API 接口
提供全國大學(xué)高校基礎(chǔ)信息福澡。
1. 產(chǎn)品功能
提供最新的全國學(xué)院基本信息以及招生數(shù)據(jù)叠赦；
總計(jì)近 3000 條全國高校精準(zhǔn)數(shù)據(jù)；
每月一次更新校正數(shù)據(jù)；
全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）除秀；
全面兼容 Apple ATS糯累；
全國多節(jié)點(diǎn) CDN 部署；
接口極速響應(yīng)册踩，多臺(tái)服務(wù)器構(gòu)建 API 接口負(fù)載均衡泳姐；
2. API 文檔
API 詳情地址: https://www.gugudata.com/api/details/college
接口請(qǐng)求地址: https://api.gugudata.com/location/college
返回格式: application/json; charset=utf-8
請(qǐng)求方式: GET
請(qǐng)求協(xié)議: HTTPS
接口測(cè)試: https://api.gugudata.com/location/college/demo
3. 請(qǐng)求參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 是否必須 | 默認(rèn)值 | 備注 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付費(fèi)后獲取的 APPKEY | ||||||||||||
| keywords | string | 是 | YOUR_VALUE | 搜索關(guān)鍵字，模糊匹配高校名稱暂吉、省市區(qū)胖秒、高校舊稱、地址字段慕的，參數(shù)值為空則返回所有數(shù)據(jù) | ||||||||||||
| pagesize | int | 否 | 10 | 每頁數(shù)據(jù)量阎肝，參數(shù)最大值為 100 | ||||||||||||
| pageindex | int | 否 | 1 | 頁碼，第幾頁數(shù)據(jù) | ||||||||||||
| keywordstrict | string | 否 | false | 控制 keyword 參數(shù)在查詢時(shí)是否進(jìn)行模糊查詢肮街，true 為精確匹配高校名稱风题，默認(rèn)值為 false 進(jìn)行模糊查詢 | ||||||||||||
| collegecategory | string | 否 | 學(xué)院類別，參數(shù)默認(rèn)值為空嫉父，不進(jìn)行篩選俯邓。可選參數(shù)為：理工類 | 綜合類 | 師范類 | 財(cái)經(jīng)類 | 醫(yī)藥類 | 藝術(shù)類 | 農(nóng)林類 | 軍事類 | 政法類 | 語言類 | 體育類 | 民族類 | 其它 |
4. 返回參數(shù)
| 參數(shù)名 | 參數(shù)類型 | 備注 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| DataStatus.StatusCode | int | 接口返回狀態(tài)碼 | ||||||||||||
| DataStatus.StatusDescription | string | 接口返回狀態(tài)說明 | ||||||||||||
| DataStatus.ResponseDateTime | string | 接口數(shù)據(jù)返回時(shí)間 | ||||||||||||
| DataStatus.DataTotalCount | int | 此條件下的總數(shù)據(jù)量熔号，一般用于分頁計(jì)算 | ||||||||||||
| Data.SchoolUUID | string | 咕咕數(shù)據(jù)平臺(tái)高校唯一 ID稽鞭，此唯一 ID 可與 歷年高考高校錄取分?jǐn)?shù)線、歷年高考專業(yè)錄取分?jǐn)?shù)線 接口中的 SchoolUUID 進(jìn)行唯一匹配 | ||||||||||||
| Data.CollegeName | string | 學(xué)院名稱 | ||||||||||||
| Data.Province | string | 學(xué)院所在省份 | ||||||||||||
| Data.City | string | 學(xué)院所在城市 | ||||||||||||
| Data.District | string | 學(xué)院所在區(qū)縣 | ||||||||||||
| Data.Coordinate | string | 學(xué)院地理坐標(biāo)經(jīng)緯度引镊，格式為 [經(jīng)度,緯度]朦蕴，地理坐標(biāo)系為 GCJ-02。需要轉(zhuǎn)換坐標(biāo)系請(qǐng)調(diào)用地理坐標(biāo)系轉(zhuǎn)換接口 | ||||||||||||
| Data.CollegeType | string | 學(xué)院性質(zhì)弟头，值的枚舉為: 普通本科 | 獨(dú)立學(xué)院 | 尫宰ィ科（高職） | 高職高專 | 中外合作辦學(xué) | 成人教育 | HND項(xiàng)目 | 遠(yuǎn)程教育學(xué)院 | 其它 | ||||
| Data.Is985 | bool | 是否為 985 院校 | ||||||||||||
| Data.Is211 | bool | 是否為 211 院校 | ||||||||||||
| Data.IsDualClass | bool | 是否為雙一流院校 | ||||||||||||
| Data.CollegeCategory | string | 學(xué)院類別，值的枚舉為: 綜合類 | 理工類 | 師范類 | 財(cái)經(jīng)類 | 醫(yī)藥類 | 藝術(shù)類 | 農(nóng)林類 | 軍事類 | 政法類 | 語言類 | 體育類 | 民族類 | 其它 |
| Data.CollegeTags | string[] | 學(xué)院標(biāo)簽 | ||||||||||||
| Data.EduLevel | string | 學(xué)院學(xué)制赴恨，值的枚舉為: 普通本科 | 本科 | 屨钊ⅲ科（高職） | 專科 | 其它 | ||||||||
| Data.CollegeProperty | string | 學(xué)院資質(zhì)伦连，值的枚舉為: 公辦 | 民辦 | 中外合作辦學(xué) | ||||||||||
| Data.CollegeCode | string | 學(xué)院編號(hào) | ||||||||||||
| Data.Ranking | int | 全國排名雨饺，接口返回的數(shù)據(jù)結(jié)果默認(rèn)按照此數(shù)值進(jìn)行升序排列 | ||||||||||||
| Data.RankingInCategory | string | 學(xué)院所在類別下排名 | ||||||||||||
| Data.WebSite | string | 學(xué)院官網(wǎng) | ||||||||||||
| Data.CallNumber | string | 學(xué)院招生電話 | ||||||||||||
| Data.Email | string | 學(xué)院招生郵箱 | ||||||||||||
| Data.Address | string | 學(xué)院地址 | ||||||||||||
| Data.CoverImage | string | 學(xué)院校徽 | ||||||||||||
| Data.Intro | string | 學(xué)院簡介 | ||||||||||||
| Data.Expenses | string | 學(xué)院收費(fèi)（僅供參考） | ||||||||||||
| Data.OldName | string | 學(xué)院舊稱 | ||||||||||||
| Data.ShortName | string | 學(xué)院簡稱 | ||||||||||||
| Data.MajorList.MajorTitle | string | 開設(shè)專業(yè)大類 | ||||||||||||
| Data.MajorList.Majors | string[] | 此大類下開設(shè)的專業(yè) |
5. 接口響應(yīng)狀態(tài)碼
| 狀態(tài)碼 | 狀態(tài)碼解釋 | 備注 |
|---|---|---|
| 100 | 正常返回 | 可通過判斷此狀態(tài)碼斷言接口正常返回 |
| -1 | 請(qǐng)求失敗 | 請(qǐng)求處理請(qǐng)求失敗 |
| 501 | 參數(shù)錯(cuò)誤 | 請(qǐng)檢查您傳遞的參數(shù)個(gè)數(shù)以及參數(shù)類型是否匹配 |
| 502 | 請(qǐng)求頻率受限 | 一般建議每秒請(qǐng)求不超過 100 次 |
| 503 | APPKEY 權(quán)限超限/訂單到期 | 請(qǐng)至開發(fā)者中心檢查您的 APPKEY 是否到期或是否權(quán)限超限 |
| 504 | APPKEY 錯(cuò)誤 | 請(qǐng)檢查傳遞的 APPKEY 是否為開發(fā)者中心獲取到的值 |
| 505 | 請(qǐng)求的次數(shù)超出接口限制 | 請(qǐng)檢查對(duì)應(yīng)接口是否有請(qǐng)求次數(shù)限制以及您目前的接口請(qǐng)求剩余次數(shù) |
| 900 | 接口內(nèi)部響應(yīng)錯(cuò)誤 | 接口可用性為 99.999%惑淳，如獲取到此狀態(tài)碼請(qǐng)郵件聯(lián)系我們 |
6. 開發(fā)語言請(qǐng)求示例代碼
示例代碼包含的開發(fā)語言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等额港，其他語言進(jìn)行對(duì)應(yīng)的 RESTful API 請(qǐng)求實(shí)現(xiàn)即可。
7. 常見問題 Q&A
-
Q: 數(shù)據(jù)請(qǐng)求有緩存嗎歧焦？
A: 所有的數(shù)據(jù)都是直接返回的移斩，部分周期性數(shù)據(jù)在更新周期內(nèi)數(shù)據(jù)是緩存的。
-
Q: 如何保證請(qǐng)求時(shí) key 的安全性？
A: 一般建議將對(duì)我們 API 的請(qǐng)求放置在您應(yīng)用的后端服務(wù)中發(fā)起向瓷，您應(yīng)用的所有前端請(qǐng)求都應(yīng)該指向您自己的后端服務(wù)肠套，這樣的架構(gòu)也更加地純粹且易維護(hù)。
-
Q: 接口可以用于哪些開發(fā)語言猖任？
A: 可以使用于所有可以進(jìn)行網(wǎng)絡(luò)請(qǐng)求的開發(fā)語言你稚，用于您項(xiàng)目快速地進(jìn)行數(shù)據(jù)構(gòu)建。
-
Q: 接口的性能可以保證嗎超升？
A: 接口后臺(tái)架構(gòu)和我們給企業(yè)提供的商業(yè)項(xiàng)目架構(gòu)一致入宦，您可以通過訪問測(cè)試接口查看接口相關(guān)返回性能與信息哺徊。
咕咕數(shù)據(jù)室琢，專業(yè)的數(shù)據(jù)提供商，提供專業(yè)全面的數(shù)據(jù)接口落追、商業(yè)數(shù)據(jù)分析盈滴，讓數(shù)據(jù)成為您的生產(chǎn)原料。
咕咕數(shù)據(jù)基于我們七年來為企業(yè)客戶提供的千億級(jí)數(shù)據(jù)存儲(chǔ)與性能優(yōu)化轿钠、相關(guān)海量基礎(chǔ)數(shù)據(jù)支撐巢钓，將合規(guī)的部分通用數(shù)據(jù)、通用功能抽象成產(chǎn)品級(jí)數(shù)據(jù) API疗垛，大大滿足了用戶在產(chǎn)品開發(fā)過程中對(duì)基礎(chǔ)數(shù)據(jù)的需求症汹，同時(shí)降低了海量數(shù)據(jù)的存儲(chǔ)與運(yùn)維成本，以及復(fù)雜功能的技術(shù)門檻與人力開發(fā)成本贷腕。
除了我們已開放的分類數(shù)據(jù)與功能接口外背镇，還有海量數(shù)據(jù)正在整理、清洗泽裳、整合瞒斩、構(gòu)建中，后期會(huì)開放更多的數(shù)據(jù)與云端功能接口 API 供用戶使用涮总。
