#HTTP接口设计文档
此文档为开发HTTP接口的设计文档,目前用于提供天气查询的相关接口。HTTP接口计划采用golang语言开发,交互方式为json。
## 1 获取服务版本接口
```GETURL: http://www.xmetrixTech.com/weather/get_version ```
请求的json(无)``````
返回的json```{ "code": 0, "message": "SUCCEED", "body": { "version": "0.1.0" }}```
## 2 根据编号查询天气
```GET URL: http://www.xmetrixTech.com/weather/v1/get_weather_by_citycode
```
请求的json```{ "token":"abcdefghigklmn", "city_code":"10020234"}```
返回的json:```{ "code": 0, "message": "SUCCEED", "body": { "city_code": "101010100", "city_name": "北京", "weather": "晴转多云", "high_temperature": "6℃", "low_temperature": "-2℃", "air_quality": "", "sun_up": "07:17", "sun_down": "16:51" }}```
## 3 根据名称查询天气
```GET URL: http://www.xmetrixTech.com/weather/v1/get_weather_by_cityname
```
请求的json```{ "token":"abcdefghigklmn", "city_name":"北京"}```
返回的json:```{ "code": 0, "message": "SUCCEED", "body": { "city_code": "101010100", "city_name": "北京", "weather": "晴转多云", "high_temperature": "6℃", "low_temperature": "-2℃", "air_quality": "", "sun_up": "07:17", "sun_down": "16:51" }}```
## 4 获取城市编号```GET URL: http://www.xmetrixTech.com/weather/v1/get_city_code
```
请求的json```{ "token":"abcdefghigklmn", "city_name":"北京"}```
返回的json:```{ "code": 0, "message": "Succeed", "body": [ { "city_code": "1010101100", "city_name": "朝阳", "country": "中国", "province": "北京", "city": "2", "county": "2", "addr": "2" }, { "city_code": "101010102", "city_name": "朝阳", "country": "中国", "province": "黑龙江", "city": "2", "county": "2", "addr": "2" } ]}```
转载于:https://www.cnblogs.com/Dennis-mi/articles/8149011.html
相关资源:天气API接口 - 城市代码