中國天氣網API(最新介面)
一、 產品概述 |
SmartWeatherAPI 介面(簡稱”SWA”介面)是中國氣象局面向 |
網路媒體、手機廠商、第三方氣象服務機構等使用者,通過 web 方 |
式提供資料氣象服務的官方載體。 |
二、 使用說明 |
該資料主要包括預警、實況、指數、常規預報(24 小時)等數 |
據內容。 |
三、 呼叫規範 |
規範用於指導三方合作伙伴合理呼叫預警、實況、指數、 |
常規預報(24 小時)等服務資料。 |
請求方式:http get |
介面組成:由固定 URL 加 5 個不同的引數組成,完整 URL 需客戶 |
端經過固定方式加密後使用。 |
資料返回:json |
完整 URL: |
http://open.weather.com.cn/data/?areaid=""&type=""&date= |
""&appid=""&key=".urlencode($key); |
固定 URL:http://open.weather.com.cn/data/ |
輸入引數: |
加密方式: |
Ø private_key |
示例:見 private_key.txt 附件 |
private_key 僅負責與 public_key 共同合成 key 傳參,私鑰 |
不可見,客戶端與服務端各儲存一份; |
Ø public_key 為不包含 key 在內的完整 URL 其它部分(此處 |
appid 為完整 appid) |
示例: |
http://open.weather.com.cn/data/?areaid=101010100&ty |
pe=forecast&date=201211281030&appid=cf2d61521456sads |
Ø key 的演算法 |
key=base64_encode(hash_hmac('sha1',$public_key,$priva |
te_key,TRUE)); |
key 加密後通過 urlencode 對其編碼後傳參 |
注:每一個產品使用使用者分配一個唯一標識 appid,用於統計 |
使用者訪問情況、區分使用者提供差異服務,終端使用者按照終端型號 |
四、 服務內容 |
4.1 實況 |
介面描述:返回當前實況資訊,每個欄位都放有當前的資料。(如 |
果沒有資料用 ? 表示) |
介面請求方式:http get |
介面返回型別:json |
輸入示例: |
http://open.weather.com.cn/data/?areaid=101010100&type |
=observe&date=201212031008&appid=cf2d61&key=w%2B1%2Bfv |
ngN50nJJh6xdu6Mfu7jxg%3D |
4.2 常規預報 |
介面描述: 返回 1 天 24 小時常規預報資料 |
介面請求方式:http get |
介面返回型別:json |
輸入示例: |
http://open.weather.com.cn/data/?areaid=101010100&type |
=forecast1d&date=201212010741&appid=cf2d61&key=hPZf1%2 |
F5Ag%2F4JS2A%2BcYmpj5Yv2YA%3D |