2. API請求方式

每組密鑰由“公鑰”（參數(shù)uid）和“私鑰”（參數(shù)key）組成，例如：

• 公鑰 PKwiV7auWJE3iBJ8d
• 私鑰 SMEieQjde1C9eXnbE

心知天氣支持兩種 API 安全驗證方式：

1. “私鑰” 直接請求方式（更簡單）

將 API 密鑰中的“私鑰”作為 API 請求中的 key 參數(shù)值：

curl https://api.seniverse.com/v3/weather/now.json?key=your_private_key&location=beijing&language=zh-Hans&unit=c



將your_private_key更改為私鑰即可

說明：此方式較為方便，但請注意不要泄漏你的“私鑰”。

2. “公鑰 + 私鑰” 簽名驗證方式（更安全）

“公鑰 + 私鑰” 驗證方式更加安全。請求地址中只包含你的“公鑰”以及用你的“私鑰”制作的簽名，因此不會在請求地址中泄露你的私鑰。

3. 接口說明

接口地址

curl https://api.seniverse.com/v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c

將your_private_key更改為私鑰即可

請求參數(shù)說明

4. 返回數(shù)據(jù)

{

  "results": [

    {

      "location": {

        "id": "C23NB62W20TF",

        "name": "西雅圖",

        "country": "US",

        "path": "西雅圖,華盛頓州,美國",

        "timezone": "America/Los_Angeles",

        "timezone_offset": "-07:00"

      },

      "now": {

        "text": "多云", //天氣現(xiàn)象文字

        "code": "4", //天氣現(xiàn)象代碼

        "temperature": "14", //溫度，單位為c攝氏度或f華氏度

        "feels_like": "14", //體感溫度，單位為c攝氏度或f華氏度，暫不支持國外城市。

        "pressure": "1018", //氣壓，單位為mb百帕或in英寸

        "humidity": "76", //相對濕度，0~100，單位為百分比

        "visibility": "16.09", //能見度，單位為km公里或mi英里

        "wind_direction": "西北", //風向文字

        "wind_direction_degree": "340", //風向角度，范圍0~360，0為正北，90為正東，180為正南，270為正西

        "wind_speed": "8.05", //風速，單位為km/h公里每小時或mph英里每小時

        "wind_scale": "2", //風力等級，請參考：http://baike.baidu.com/view/465076.htm

        "clouds": "90", //云量，單位%，范圍0~100，天空被云覆蓋的百分比 #目前不支持中國城市#

        "dew_point": "-12" //露點溫度，請參考：http://baike.baidu.com/view/118348.htm #目前數(shù)據(jù)缺失中#

      },

      "last_update": "2015-09-25T22:45:00-07:00" //數(shù)據(jù)更新時間（該城市的本地時間）

    }

  ]

}

5. 常見問題

__Q：如何找到__心知天氣API

A：冪簡集成是國內領先的API集成管理平臺，專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’知乎熱搜榜API‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。

Q：服務期到期和超額？
A：服務到期或訪問量用盡，數(shù)據(jù)調用將會自動中斷。請您注意查收我們的報警郵件，我們將在服務到期或訪問量用盡之前數(shù)天提供多次郵件通知，請及時登錄您的賬號，進行續(xù)費購買。訪問量不夠的情況，請您升級單獨購買訪問量即可。

Q：氣象數(shù)據(jù)來源？
A：中國氣象局氣象數(shù)據(jù)中心是中國氣象數(shù)據(jù)的官方授權機構。心知天氣是中國氣象局氣象數(shù)據(jù)中心的戰(zhàn)略合作伙伴，擁有正規(guī)合法的數(shù)據(jù)授權。使用心知天氣數(shù)據(jù)服務，可合法用于商業(yè)用途。

__Q：穩(wěn)定性保障與賠償？__

A：心知接口已累計調用超過500億次。服務穩(wěn)定性達到99.99%；百倍賠償（每1小時故障，賠100小時使用時長）；如有合同，將按照合同約定進行補償。

Q：__免費用戶可以調用哪些數(shù)據(jù)？__

A：國內 370 個主要城市

1. 天氣實況，包括天氣現(xiàn)象文字、代碼和氣溫 3 項數(shù)據(jù)
2. 未來 3 天天氣預報，包括白天天氣現(xiàn)象文字及代碼、晚間天氣現(xiàn)象文字及代碼、當天最高溫度和最低溫度、風向風速
3. 6 項基本類生活指數(shù)，包括穿衣、紫外線強度、洗車、旅游、感冒、運動指數(shù)

__Q：API訪問量如何計算__？

A：每調用一次任意 API 接口，即計一次訪問，即 10 萬次訪問量即可以調用 10 萬次 API 接口。 比如：無論是調用weather/now.json還是location/search.json都是記一次訪問量。 訪問量余額不足時，API 服務會自動終止，請及時關注您的訪問量余額，避免影響使用。

提供天氣查詢 API的服務商除知心天氣 API，還有其他替代服務商也提供類似api服務，例如：

天氣預警-API Space

未來7天生活指數(shù)-API Space

天氣預報查詢-API Space

更多競品可以在冪簡集成開放平臺中找到。

Q：知心天氣查詢__秘鑰還適用于哪些api？__

天氣實況

分鐘級降水預報

逐日天氣預報和昨日天氣

24小時逐小時天氣預報

6. 總結

本文總結了如何獲取心知天氣API密鑰的分步指南，從申請流程到密鑰獲取，為開發(fā)者提供了清晰的步驟。同時，還概述了在獲取和使用API密鑰過程中可能需要注意的事項，如API的使用限制、密鑰的安全性管理等，幫助開發(fā)者順利集成心知天氣API到應用中。