FOXAPI 是一個針對開發者提供一些預先定義的接口,通過該接口開發者可以獲取到相應的數據信息,方便開發者調用數據,從而間接減少代碼編寫。
基本介紹
- 中文名:FOXAPI
- 返回機制:通過用戶提交需要的數據而返回
- 使用優點1:減少伺服器檢索數據負擔
- 優點2:減少編碼檢索數據的代碼
何時使用,返回機制,使用優點,示例,
何時使用
當開發者遇到數據查詢時,如:天氣預報、股票信息、網站數據等查詢時,就可以使用到它,它將會以預先設定好的格式展示出來。
返回機制
使用優點
使用它將會:減少伺服器檢索數據負擔、減少編碼檢索數據的代碼、縮減檢索數據流程等等,使開發者更加快捷的查詢各種數據。
示例
這裡就拿天氣預報的API做例子,調用地址去官網可以查到。
說明
天氣預報獲取接口。
您可以方便的利用天氣預報API接口開發您自己的天氣預報應用程式或網站。
參數說明
可傳參數,如下:
參數 | 類型 | 是否可選 | 意義 | 枚舉 | 備註 |
---|---|---|---|---|---|
city | String | 是 | 城市 | 默認:北京 | |
day | String | 是 | 天 | 0表示當天天氣, 1表示第二天的天氣, 2表示第三天的天氣,以此類推,最大為4。 默認:0 | |
apiid | String | 否 | API標識碼 | FOXAPI每個套用都必須使用APIID,用來記錄API操作。 | |
alt | Alt | 是 | 返回的數據格式 | 1.xml → XML形式展示數據; 2.json → json形式展示數據; | 默認:xml |
返回內容
該API返回的網站信息,如下:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<city>北京</city>
<status1>小雨</status1>
<status2>多雲</status2>
<direction1>無持續風向</direction1>
<direction2>無持續風向</direction2>
<power1>≤3</power1>
<power2>≤3</power2>
<temperature1>28</temperature1>
<temperature2>21</temperature2>
<ssd_l>偏熱</ssd_l>
<ssd_s>天氣偏熱,適當調整穿衣後,仍可達到比較舒適的程度。</ssd_s>
<zwx_l>最弱</zwx_l> <zwx_s>紫外線最弱</zwx_s>
<ktk_l>不需要開啟</ktk_l>
<ktk_s>不需要開啟空調</ktk_s>
<pollution_l>一般</pollution_l>
<pollution_s>對空氣污染物擴散無明顯影響</pollution_s>
<chy_l>薄短袖類</chy_l>
<chy_shuoming>短袖衫、短裙、短褲、薄型T恤衫、敞領短袖棉衫</chy_shuoming>
<xcz_l>不適宜</xcz_l>
<xcz_s>洗車後當日有降水、大風或沙塵天氣,不適宜洗車</xcz_s>
<gm_l>低發期</gm_l>
<gm_s>環境溫度較高,要提防長時間在空調環境中引發的空調病;</gm_s>
<yd_l>不太適宜</yd_l> <yd_s>天氣較熱,不太適宜戶外運動;</yd_s>
</root>
參數說明:
參數 | 類型 | 意義 | 備註 |
---|---|---|---|
city | String | 城市 | |
status1 | String | 白天天氣情況 | |
status2 | String | 晚上天氣情況 | |
direction1 | String | 白天風向 | |
direction2 | String | 晚上風向 | |
power1 | String | 白天風力 | |
power2 | String | 晚上風力 | |
temperature1 | String | 白天溫度 | |
temperature2 | String | 晚上溫度 | |
ssd_l | String | 體感度指數 | |
ssd_s | String | 體感度指數說明 | |
zwx_l | String | 紫外線指數 | |
zwx_s | String | 紫外線指數說明 | |
ktk_l | String | 空調指數 | |
ktk_s | String | 空調指數說明 | |
pollution_l | String | 污染物擴散條件 | |
pollution_s | String | 污染物擴散條件說明 | |
chy_l | String | 穿衣指數 | |
chy_shuoming | String | 穿衣指數說明 | |
xcz_l | String | 洗車指數 | |
xcz_s | String | 洗車指數說明 | |
gm_l | String | 感冒指數 | |
gm_s | String | 感冒指數說明 | |
yd_l | String | 運動指數 | |
yd_s | String | 運動指數說明 | |
errormsg | String | API錯誤信息 | 當訪問API出現錯誤時,數據裡面將出現此節點,否則不出現。 |