[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. 发布并查看发布状态
![](https://box.kancloud.cn/a1aa4f66c6d69eb21071cc943f276b54_306x78.png)
![](https://box.kancloud.cn/2dff5ff229ee8a1e5c1070f3f5c63783_434x188.png)
![](https://box.kancloud.cn/b8cbd691fac4c2cab04618e520fa2394_232x419.png)
![](https://box.kancloud.cn/c83ad9999467f83e82dd8a3b98d378e4_1398x396.png)
## 3. 查看最终发布结果
- 打造高逼格接口管理平台
- 开篇
- 课程简介
- 聊聊接口平台
- 接口平台简介
- 优雅的使用看云
- 接口和markdown
- 接口文档版本演进
- 微软的硬菜--vscode
- markdown基础语法
- markdown进阶语法--流程图
- markdown进阶语法--时序图
- markdown进阶语法--API文档
- 接口文档的基本概念
- 接口管理平台的基本元素
- 编写接口文档并且发布更新
- 接口安全
- 文档安全
- 接口安全
- Git化你的文档
- 使用Git管理文档
- 自动化
- 自动化文档更新
- 收尾
- 如何反馈问题
- 课程总结
- 示例
- 更新信息
- 查询历史天气
- markdown语法示例
- 流程图示例
- 时序图示例
- 登录/注册
- 数据字典示例
- 课程问题解答