#HTTP接口设计文档
此文档为开发HTTP接口的设计文档,目前用于提供天气查询的相关接口。
HTTP接口计划采用golang语言开发,交互方式为json。
## 1 获取服务版本接口
```
GET
URL: 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"
}
]
}
```