在鸿云文档Appearance
getWeather
调用该接口获取城市天气信息
使用说明
请求头必须带token信息。
请求方式
POST
请求参数
CityWeatherReq
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| cityName | String | 否 | 城市名称 |
| cityCode | String | 是 | 城市编码 |
返回数据
CityWeatherResp
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | string | true | none | 返回编码0是成功 | none |
| » msg | string | true | none | 返回消息 | none |
| » data | object | true | none | none | |
| »» station | object | true | none | 站点信息 | none |
| »»» id | null | true | none | none | |
| »»» url | string | true | none | 城市跳转地址 | none |
| »»» code | string | true | none | 城市编码 | none |
| »»» city | string | true | none | 城市名称 | none |
| »»» province | string | true | none | 省份名称 | none |
| »» publishTime | string | true | none | 发布时间 | none |
| »» weather | object | true | none | 天气预报 | none |
| »»» temperature | number | true | none | 当前气温 | 值为9999是异常值无需显示 |
| »»» temperatureDiff | number | true | none | 温差 | 值为9999是异常值无需显示 |
| »»» airpressure | integer | true | none | 气压 单位Pa | none |
| »»» humidity | integer | true | none | 相对湿度 | none |
| »»» rain | integer | true | none | 雨量等级 | none |
| »»» rcomfort | integer | true | none | 舒适度 | none |
| »»» icomfort | integer | true | none | 舒适度图标 | none |
| »»» info | string | true | none | 当前天气状况 | none |
| »»» img | string | true | none | 天气图标 | 值为9999是异常值无需显示 |
| »»» feelst | number | true | none | 体感温度 | 值为9999是异常值无需显示 |
| »»» airQuality | null | true | none | 值为9999是异常值无需显示 | |
| »» wind | object | true | none | 风量信息 | 值为9999是异常值无需显示 |
| »»» direct | string | true | none | 风向 | 值为9999是异常值无需显示 |
| »»» power | string | true | none | 风力 | 值为9999是异常值无需显示 |
| »»» speed | string | true | none | 风速 | 值为9999是异常值无需显示 |
| »» warn | object | true | none | 警告信息 | 值为9999是异常值无需显示 |
| »»» alert | string | true | none | 值为9999是异常值无需显示 | |
| »»» pic | string | true | none | none | |
| »»» province | string | true | none | none | |
| »»» city | string | true | none | none | |
| »»» url | string | true | none | none | |
| »»» issuecontent | string | true | none | none | |
| »»» fmeans | string | true | none | none |
示例
请求示例
json
{
"cityName": "虎林",
"cityCode": "50983"
}返回示例
json
{
"code": "0",
"msg": "操作成功",
"data": {
"station": {
"id": null,
"url": "http://www.nmc.cnhttp://www.nmc.cn/publish/forecast/AHL/hulin.html",
"code": "50983",
"city": "虎林",
"province": "黑龙江省"
},
"publishTime": "2023-03-01 10:15",
"weather": {
"temperature": -2.5,
"temperatureDiff": -4.3,
"airpressure": 9999,
"humidity": 39,
"rain": 0,
"rcomfort": 32,
"icomfort": -3,
"info": "晴",
"img": "0",
"feelst": -6.4,
"airQuality": null
},
"wind": {
"direct": "西北风",
"power": "微风",
"speed": "2.3"
},
"warn": {
"alert": "2023年02月28日09时黑龙江省鸡西市虎林市气象台发布寒潮蓝色预警信号",
"pic": "http://image.nmc.cn/assets/img/alarm/p0004004.png",
"province": "黑龙江省",
"city": "鸡西市",
"url": "/publish/alarm/23038141600000_20230228092446.html",
"issuecontent": "虎林气象台2023年2月28日9时30分发布寒潮蓝色预警信号：预计未来48小时内，虎林地区最低气温将下降8℃以上，请有关单位和个人做好预防工作。",
"fmeans": "1.政府及有关部门按照职责做好防寒潮准备工作；2.注意添衣保暖；3.对热带作物、水产品采取一定的防护措施；4.做好防风准备工作。"
}
}
}错误码
| 错误码 | 错误码取值 | 解决方案 |
|---|---|---|
| 0-100006 | 鉴权参数为空 | 请确保传递入参。 |
| 0-101079 | 账号被禁用请联系管理员 | 联系管理员 |
| 0-101080 | 账号已失效 | 联系管理员 |
| 0-101081 | 当前账号暂未分配权限 | 联系管理员 |