[toc=2]
# 創建一個[查詢歷史天氣](queryweather.md)接口文檔
> 接口服務來源[聚合數據](https://www.juhe.cn/docs/api/id/277 )
## 入參和出參
#### 入參
* `key`: 申請的key,個人中心我的數據列表查看
* `city_id`: 城市地區ID
* `weather_date`: 日期,格式:2017-07-15,日期不能大于等于今日日期
#### 出參
* `error_code`: 返回碼
* `reason`: 返回說明
* `result`: 返回結果集
* `city_id`: 城市地區ID
* `city_name`: 城市地區名稱
* `weather_date`: 天氣日期
* `day_weather`: 白天天氣
* `night_weather`: 夜間天氣
* `day_temp`: 白天最高溫度
* `night_temp`: 夜間最低溫度
* `day_wind`: 白天風向
* `day_wind_comp`: 白天分力
* `night_wind`: 夜間風向
* `night_wind_comp`: 夜間風力
* `day_weather_id`: 白天天氣標識
* `night_weather_id`: 夜間天氣標識
## 錯誤碼
1. 城市id是否正確(不傳就是不正確)
1. 日期格式是否正確(不傳就是不正確)
## 接口說明
* 根據城市ID和日期查詢歷史天氣信息,日期支持從2011-01-01開始
# 為接口文檔增加在線調試功能
## 1. 修改配置文件
```json
{
"plugins": [
"api",
"highlight"
],
"pluginsConfig": {
"api": {
"url": "http://v.juhe.cn",
"headers": {
"Charset": "utf-8",
"Cache-Control": "no-cache"
},
"explore": true
}
}
}
```
## 2. 解決跨域問題
#### 1. 第一種解決方案
* 安裝看云的[chrome瀏覽器擴展代理請求](https://pan.baidu.com/s/1J8Na6gRnRGr93_qD1ZBDcg)插件
#### 2. 第二種解決方案
* 設置服務器代碼, 解決跨域問題
* 把網站設置成https
# 發布文檔更新
## 1. 編寫文檔更新
* 確定更新說明
* 確定更新日期
* 確定新增接口名稱和鏈接
## 2. 發布并查看發布狀態




## 3. 查看最終發布結果
- 打造高逼格接口管理平臺
- 開篇
- 課程簡介
- 聊聊接口平臺
- 接口平臺簡介
- 優雅的使用看云
- 接口和markdown
- 接口文檔版本演進
- 微軟的硬菜--vscode
- markdown基礎語法
- markdown進階語法--流程圖
- markdown進階語法--時序圖
- markdown進階語法--API文檔
- 接口文檔的基本概念
- 接口管理平臺的基本元素
- 編寫接口文檔并且發布更新
- 接口安全
- 文檔安全
- 接口安全
- Git化你的文檔
- 使用Git管理文檔
- 自動化
- 自動化文檔更新
- 收尾
- 如何反饋問題
- 課程總結
- 示例
- 更新信息
- 查詢歷史天氣
- markdown語法示例
- 流程圖示例
- 時序圖示例
- 登錄/注冊
- 數據字典示例
- 課程問題解答