[DEMO] 全国天气预报信息

全国天气预报信息
接口详情官网地址: https://www.gugudata.com/api/details/weatherinfo

精确到行政区的7日天气预报

请求方法: GET
接口路径: /weather/weatherinfo
调试地址: https://api.gugudata.com/weather/weatherinfo/sz
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求参数:

appkey (string, 必填): 付费后获取的 APPKEY

code (string, 必填): 地区编码，可通过前置接口查询获得地区编码。

days (int, 可选): 获取天气预报的天数，默认为1，即为当天数据。最大值为7。

返回字段:

DataStatus.StatusCode: 接口返回状态码

DataStatus.StatusDescription: 接口返回状态说明

DataStatus.ResponseDateTime: 接口数据返回时间

DataStatus.DataTotalCount: 此条件下的总数据量

Data.Code: 地区编码

Data.WeatherDate: 天气预报的日期

Data.WeatherRegion: 当前天气预报的详细地区信息，数据格式与查询地区编码接口返回数据格式一致。

Data.WeatherRegion.ReginType: 位置信息类型，2为市级别数据，3为区级别数据

Data.WeatherRegion.Code: 地区完整编码

Data.WeatherRegion.ProvinceCode: 省编码

Data.WeatherRegion.ProvinceName: 省名称

Data.WeatherRegion.CityCode: 市编码

Data.WeatherRegion.CityName: 市名称

Data.WeatherRegion.RegionCode: 区编码

Data.WeatherRegion.RegionName: 区名称

Data.WeatherRegion.TownCode: 镇编码

Data.WeatherRegion.TownName: 镇名称

Data.WeatherInfo: 天气情况

Data.TemperatureHigh: 最高温度

Data.TemperatureLow: 最低温度

Data.TodayHistoryHighestTemperature: 当日历史最高温度（历史均值）

Data.TodayHistoryLowestTemperature: 当日历史最低温度（历史均值）

Data.WeatherWindCondition1: 风向1

Data.WeatherWindCondition2: 风向2

Data.WeatherWindLevel: 风级

Data.SunRiseTime: 日出时间

Data.SunSetTime: 日落时间

Data.WeatherPerHour: 当日小时级别的天气预报数据数组

Data.WeatherPerHour.WeatherTime: 预报的小时时间，24小时制

Data.WeatherPerHour.WeatherInfo: 天气情况，天气情况枚举值：晴|多云|阴|阵雨|雷阵雨|雷阵雨伴有冰雹|雨夹雪|小雨|中雨|大雨|暴雨|大暴雨|特大暴雨|阵雪|小雪|中雪|大雪|暴雪|雾|冻雨|沙尘暴|小雨-中雨|中雨-大雨|大雨-暴雨|暴雨-大暴雨|大暴雨-特大暴雨|小雪-中雪|中雪-大雪|大雪-暴雪|浮尘|扬沙|强沙尘暴|霾

Data.WeatherPerHour.Temperature: 温度

Data.WeatherPerHour.Wet: 空气湿度

Data.WeatherPerHour.WeatherWindCondition: 风向

Data.WeatherPerHour.WeatherWindLevel: 风级

Data.LifeHelperUV: UV指数

Data.LifeHelperWear: 穿衣指数

Data.LifeHelperWashCar: 洗车指数

Data.LifeHelperAir: 空气指数

Data.LifeHelper.HelperName: 指数名称

Data.LifeHelper.HelperStatus: 指数状态

Data.LifeHelper.HelperValue: 指数值。总分：紫外线5分，穿衣7分，洗车4分，空气5分

Data.LifeHelper.HelperContent: 指数内容

Data.WeatherDataGenerateDateTime: 天气预报内容数据生成时间

HTTP 状态码:

200 接口正常响应: 业务状态码请结合响应体中的状态字段判断。

400 请求参数错误: 参数缺失、格式错误或非法组合。

401 鉴权失败: 缺少 APPKEY 或 APPKEY 无效。

403 无权限或额度不可用: 订单到期、权限不足或剩余额度不可用。

404 资源不存在: 请求路径不存在。

405 请求方法不允许: 请求方法与接口定义不匹配。

415 请求内容类型不支持: 文件上传或请求体格式不符合要求。

429 请求频率超限: 触发接口或网关限流策略。

500 服务内部异常: 服务执行异常，请联系技术支持。

502 上游依赖异常: 上游服务响应异常或暂不可用。

业务状态码:

100 正常返回: 暂无说明

101 参数错误: 暂无说明

102 请求频率受限: 每分钟请求不能超过 100 次

103 账号欠费: 暂无说明

104 APPKEY 错误: 请检查传递的 APPKEY 是否为开发者中心获取到的值

110 接口响应错误: 暂无说明

接口特性:

全国天气预报数据，每隔 6 小时更新；

包含湿度信息；

精确到行政区级别的天气预报数据；

提供最长 7 天的天气预报数据；

提供每日小时级别的天气预报数据；

提供本地日出日落、当日历史温度等附加数据；

提供紫外线、穿衣、洗车、空气污染等额外指导数据；

全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；

全面兼容 Apple ATS；

全国多节点 CDN 部署；

接口极速响应，多台服务器构建 API 接口负载均衡；

请求参数

请求示例代码

返回响应