1. 產品功能

提供最新的全國學院基本信息以及招生數據；
總計近 3000 條全國高校精准數據；
每月一次更新校正數據；
全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
全面兼容 Apple ATS；
全國多節點 CDN 部署；
接口極速響應，多台服務器構建 API 接口負載均衡。

2. API 文檔

API 詳情地址: https://www.gugudata.com/api/details/college

接口請求地址: https://api.gugudata.com/location/college

返回格式: application/json; charset=utf-8

請求方式: GET

請求協議: HTTPS

請求示例: https://api.gugudata.com/location/college?appkey=YOUR_APPKEY&keywords=YOUR_VALUE&pagesize=10&pageindex=1

接口測試: https://api.gugudata.com/location/college/demo

3. 請求參數（如果為 POST 請求，那么參數以 JSON 的格式傳遞）

參數名	參數類型	是否必須	默認值	備注
appkey	string	是	YOUR_APPKEY	付費后獲取的 APPKEY
keywords	string	是	YOUR_VALUE	搜索關鍵字，模糊匹配高校名稱、省市區、高校舊稱、地址字段，參數值為空則返回所有數據
pagesize	int	否	10	每頁數據量，參數最大值為 100
pageindex	int	否	1	頁碼，第幾頁數據
keywordstrict	string	否	false	控制 keyword 參數在查詢時是否進行模糊查詢，true 為精確匹配高校名稱，默認值為 false 進行模糊查詢
collegecategory	string	否		學院類別，參數默認值為空，不進行篩選。可選參數為：理工類\|綜合類\|師范類\|財經類\|醫葯類\|藝術類\|農林類\|軍事類\|政法類\|語言類\|體育類\|民族類\|其它

4. 返回參數

參數名	參數類型	備注
DataStatus.StatusCode	int	接口返回狀態碼
DataStatus.StatusDescription	string	接口返回狀態說明
DataStatus.ResponseDateTime	string	接口數據返回時間
DataStatus.DataTotalCount	int	此條件下的總數據量，一般用於分頁計算
Data.SchoolUUID	string	咕咕數據平台高校唯一 ID，此唯一 ID 可與歷年高考高校錄取分數線、歷年高考專業錄取分數線接口中的 SchoolUUID 進行唯一匹配
Data.CollegeName	string	學院名稱
Data.Province	string	學院所在省份
Data.City	string	學院所在城市
Data.District	string	學院所在區縣
Data.Coordinate	string	學院地理坐標經緯度，格式為 [經度,緯度]，地理坐標系為 GCJ-02。需要轉換坐標系請調用地理坐標系轉換接口
Data.CollegeType	string	學院性質，值的枚舉為: 普通本科\|獨立學院\|專科（高職）\|高職高專\|中外合作辦學\|成人教育\|HND項目\|遠程教育學院\|其它
Data.Is985	bool	是否為 985 院校
Data.Is211	bool	是否為 211 院校
Data.IsDualClass	bool	是否為雙一流院校
Data.CollegeCategory	string	學院類別，值的枚舉為: 綜合類\|理工類\|師范類\|財經類\|醫葯類\|藝術類\|農林類\|軍事類\|政法類\|語言類\|體育類\|民族類\|其它
Data.CollegeTags	string[]	學院標簽
Data.EduLevel	string	學院學制，值的枚舉為: 普通本科\|本科\|專科（高職）\|專科\|其它
Data.CollegeProperty	string	學院資質，值的枚舉為: 公辦\|民辦\|中外合作辦學
Data.CollegeCode	string	學院編號
Data.Ranking	int	全國排名
Data.RankingInCategory	string	學院所在類別下排名
Data.WebSite	string	學院官網
Data.CallNumber	string	學院招生電話
Data.Email	string	學院招生郵箱
Data.Address	string	學院地址
Data.CoverImage	string	學院校徽
Data.Intro	string	學院簡介
Data.Expenses	string	學院收費（僅供參考）
Data.OldName	string	學院舊稱
Data.ShortName	string	學院簡稱
Data.MajorList.MajorTitle	string	開設專業大類
Data.MajorList.Majors	string[]	此大類下開設的專業

5. 接口響應狀態碼

狀態碼	狀態碼解釋	備注
100	正常返回
501	參數錯誤	請檢查您傳遞的參數個數以及參數類型是否匹配
502	請求頻率受限	一般建議每秒請求不超過 100 次
503	APPKEY 權限超限/訂單到期	請至開發者中心檢查您的 APPKEY 是否到期或是否權限超限
504	APPKEY 錯誤	請檢查傳遞的 APPKEY 是否為開發者中心獲取到的值
505	請求的次數超出接口限制	請檢查對應接口是否有請求次數限制以及您目前的接口請求剩余次數
900	接口響應錯誤	接口可用性為 99.999%，如獲取到此狀態碼請郵件聯系我們

6. 開發語言請求示例代碼

示例代碼包含的開發語言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他語言進行對應的 RESTful API 請求實現即可。

示例代碼截圖

咕咕數據，專業的數據提供商，提供專業全面的數據接口、商業數據分析，讓數據成為您的生產原料。

咕咕數據基於我們五年來為企業客戶提供的海量數據支撐，將部分通用數據、通用功能抽象成產品級 API，大大滿足了用戶在產品開發過程中對基礎數據的需求，同時降低了復雜功能的實現門檻與人力成本。

除了我們已開放的分類數據與接口外，還有海量數據正在整理、清洗、整合、構建中，后期會開放更多的數據與雲端功能接口供用戶使用。

目前已開放的數據接口 API

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 創業基礎（第六章：創業資源及其管理）來自高校：全國大學生創新創業實踐聯盟分類：創新創業學習規則：按序學習創業基礎（第三章：創業機會及其識別與評價）來自高校：全國大學生創新創業實踐聯盟分類：創新創業學習規則：按序學習創業基礎（第四章：創業風險及識別與管理）來自高校：全國大學生創新創業實踐聯盟分類：創新創業學習規則：按序學習 2019全國大學生信息安全競賽ciscn-writeup(4web) 2020第十三屆全國大學生信息安全創新實踐大賽 z3 全國大學生信息安全競賽—創新實踐能力賽初賽部分wp 2018全國大學信息安全競賽wp(2misc+2crypto+1web) 全國大學生信息安全競賽初賽writeup 全國大學生信息安全競賽初賽2020writeup CISCN2021-第十四屆全國大學生信息安全競賽-WriteUp