{
"openapi": "3.0.3",
"info": {
"title": "天气预报",
"description": "可用于机器学习、人工智能数据分析。提供天气实况，通过坐标区域、IP、地名、景点名称、电话区号或邮编等有效信息可查询天气情况（天气状况、湿度、天气图标、实时温度、风向、风级、紫外线、穿衣指南、空气指数）。可查询到当前天气、未来24小时、7天、15天、40天内天气预报和过往的历史天气情况等数据。",
"termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
"version": "1.0.0"
},
"servers": [
{
"url": "https://route.showapi.com"
}
],
"paths": {
"/9-12": {
"x-pointCode": 12,
"x-mode": "mapping",
"x-read-timeout": 30,
"x-connect-timeout": 30,
"post": {
"summary": "地名--查未来40日天气预报",
"description": "根据区域code和区域名，获取当前日期至未来40天内的天气预报。因区域名可能存在重名的情况，建议尽量使用区域code来获取数据。需要说明的是未来15天的天气数据是每天7点、12点、18点各更新一次。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"ret_code": {
"type": "number"
},
"area": {
"type": "string"
},
"areaid": {
"type": "string"
},
"day40List": {
"type": "array",
"items": {
"type": "object",
"properties": {
"0": {
"type": "object",
"properties": {
"night_weather_code": {
"type": "string",
"description": "夜晚天气代号"
},
"day_weather": {
"type": "string",
"description": "白天天气"
},
"night_weather": {
"type": "string",
"description": "夜晚天气"
},
"night_wind_power": {
"type": "string",
"description": "夜晚风力"
},
"day_wind_power": {
"type": "string",
"description": "白天风力"
},
"day_weather_code": {
"type": "string",
"description": "白天天气代号"
},
"daytime": {
"type": "string",
"description": "日期"
},
"day_weather_pic": {
"type": "string",
"description": "白天天气图片"
},
"night_air_temperature": {
"type": "string",
"description": "夜晚气温"
},
"day_air_temperature": {
"type": "string",
"description": "白天气温"
},
"day_wind_direction": {
"type": "string",
"description": "白天风力"
},
"night_weather_pic": {
"type": "string",
"description": "夜晚天气图片"
},
"night_wind_direction": {
"type": "string",
"description": "夜晚风力"
}
}
}
}
}
},
"areaCode": {
"type": "string"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_12_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"areaCode": {
"type": "string",
"description": "地区code. 此参数和area必须输入一个。"
},
"area": {
"type": "string",
"description": "地区名称"
}
}
}
}
}
}
}
},
"/9-10": {
"x-pointCode": 10,
"x-mode": "mapping",
"x-read-timeout": 20,
"x-connect-timeout": 20,
"post": {
"summary": "区号邮编--查询天气",
"description": "区号邮编查询天气是一种通过电话服务快速获取当地天气信息的方法。用户只需输入当地的区号或邮编，系统便会查询出当前的天气预报，包括温度、湿度、风力等信息。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "预报发布时间\n"
},
"cityInfo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"c1": {
"type": "string",
"description": "区域id"
},
"c2": {
"type": "string",
"description": "城市英文名 "
},
"c3": {
"type": "string",
"description": "城市中文名 "
},
"c4": {
"type": "string",
"description": "城市所在市英文名 "
},
"c5": {
"type": "string",
"description": "城市所在市中文名 "
},
"c6": {
"type": "string",
"description": "城市所在省英文名"
},
"c7": {
"type": "string",
"description": "城市所在省中文名"
},
"c8": {
"type": "string",
"description": "城市所在国家英文名 "
},
"c9": {
"type": "string",
"description": "城市所在国家中文名"
},
"c10": {
"type": "string",
"description": "城市级别"
},
"c11": {
"type": "string",
"description": "城市区号 "
},
"c12": {
"type": "string",
"description": "邮编"
},
"longitude": {
"type": "string",
"description": "经度"
},
"latitude": {
"type": "string",
"description": "纬度 "
},
"c15": {
"type": "string",
"description": "海拔"
},
"c16": {
"type": "string",
"description": "雷达站号 "
},
"c17": {
"type": "string",
"description": "时区"
},
"c0": {
"type": "string",
"description": "地区code"
}
}
},
"description": "查询的地区基本资料\n"
},
"f1": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day_weather": {
"type": "string",
"description": "白天天气"
},
"night_weather": {
"type": "string",
"description": "晚上天气"
},
"day_air_temperature": {
"type": "string",
"description": "白天天气温度(摄氏度) "
},
"night_air_temperature": {
"type": "string",
"description": "晚上天气温度(摄氏度) "
},
"day_wind_direction": {
"type": "string",
"description": "白天风向编号 "
},
"night_wind_direction": {
"type": "string",
"description": "晚上风向编号 "
},
"day_wind_power": {
"type": "string",
"description": "白天风力编号"
},
"night_wind_power": {
"type": "string",
"description": "晚上风力编号"
},
"sun_begin_end": {
"type": "string",
"description": "日出日落时间(中间用|分割) "
},
"index": {
"type": "array",
"items": {
"type": "object",
"properties": {
"beauty": {
"type": "string",
"description": "化妆指数"
},
"clothes": {
"type": "string",
"description": "穿衣指数"
},
"cold": {
"type": "string",
"description": "感冒"
},
"comfort": {
"type": "string",
"description": "舒适"
},
"glass": {
"type": "string",
"description": "太阳镜"
},
"sports": {
"type": "string",
"description": "运动"
},
"travel": {
"type": "string",
"description": "旅游"
},
"uv": {
"type": "string",
"description": "紫外线"
},
"wash_car": {
"type": "string",
"description": "洗车"
},
"aqi": {
"type": "string",
"description": "大气污染"
},
"ac": {
"type": "string",
"description": "空调控制"
},
"ag": {
"type": "string",
"description": "过敏指数"
},
"cl": {
"type": "string",
"description": "晨练指数"
},
"dy": {
"type": "string",
"description": "钓鱼指数"
},
"gj": {
"type": "string",
"description": "逛街指数"
},
"hc": {
"type": "string",
"description": "划船指数"
},
"ls": {
"type": "string",
"description": "晾晒指数"
},
"mf": {
"type": "string",
"description": "美发指数"
},
"nl": {
"type": "string",
"description": "夜生活指数"
},
"pj": {
"type": "string",
"description": "啤酒指数"
},
"pk": {
"type": "string",
"description": "放风筝指数"
},
"yh": {
"type": "string",
"description": "约会指数"
},
"zs": {
"type": "string",
"description": "中暑指数"
},
"xq": {
"type": "string",
"description": "心情指数"
}
}
},
"description": "指数对象"
},
"day": {
"type": "number",
"description": "当前天"
},
"weekday": {
"type": "number",
"description": "星期几"
},
"day_weather_pic": {
"type": "string",
"description": "白天天气图标"
},
"night_weather_pic": {
"type": "string",
"description": "晚上天气图标"
},
"day_weather_code": {
"type": "string",
"description": "白天的天气编码"
},
"night_weather_code": {
"type": "string",
"description": "晚上的天气编码"
},
"air_press": {
"type": "string",
"description": "大气压"
},
"jiangshui": {
"type": "string",
"description": "降水概率"
},
"ziwaixian": {
"type": "string",
"description": "紫外线"
}
}
},
"description": "今天的天气预报\n"
},
"f2": {
"type": "string",
"description": "今天+1天的天气预报\n"
},
"f3": {
"type": "string",
"description": "今天+2天的天气预报\n"
},
"f4": {
"type": "string",
"description": "今天+3天的天气预报\n"
},
"f5": {
"type": "string",
"description": "今天+4天的天气预报\n"
},
"f6": {
"type": "string",
"description": "今天+5天的天气预报\n"
},
"f7": {
"type": "string",
"description": "今天+6天的天气预报\n"
},
"now": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气指数，越小越好"
},
"sd": {
"type": "string",
"description": "空气湿度"
},
"temperature": {
"type": "string",
"description": "气温"
},
"temperature_time": {
"type": "string",
"description": "获得气温的时间"
},
"weather": {
"type": "string",
"description": "天气"
},
"weather_pic": {
"type": "string",
"description": "天气小图标"
},
"wind_direction": {
"type": "string",
"description": "风向"
},
"wind_power": {
"type": "string",
"description": "风力"
},
"aqiDetail": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气质量指数，越小越好"
},
"area": {
"type": "string",
"description": "地区"
},
"co": {
"type": "string",
"description": "一氧化碳1小时平均，mg/m3"
},
"no2": {
"type": "string",
"description": "二氧化氮1小时平均,μg/m3"
},
"o3": {
"type": "string",
"description": "臭氧1小时平均，μg/m3"
},
"o3_8h": {
"type": "string",
"description": "臭氧8小时平均，μg/m3"
},
"pm10": {
"type": "string",
"description": "颗粒物（粒径小于等于10μm）1小时平均，μg/m3"
},
"pm2_5": {
"type": "string",
"description": "颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3"
},
"primary_pollutant": {
"type": "string",
"description": "首要污染物"
},
"quality": {
"type": "string",
"description": "空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类"
},
"so2": {
"type": "string",
"description": "二氧化硫1小时平均，μg/m3"
},
"num": {
"type": "string",
"description": "排名。越小越好"
}
}
},
"description": "aqi明细数据"
},
"rain": {
"type": "string",
"description": "降水量（mm）"
}
}
},
"description": "现在实时的天气情况\n"
},
"hourDataList": {
"type": "string",
"description": "每半小时数据的累积数组。当天0点清空重新累积。\n"
},
"ret_code": {
"type": "number",
"description": "0为成功，其他失败"
},
"alarmList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"signalLevel": {
"type": "string",
"description": "预警等级"
},
"issueContent": {
"type": "string",
"description": "预警详情"
},
"issueTime": {
"type": "string",
"description": "预警时间"
},
"province": {
"type": "string",
"description": "预警省份"
},
"signalType": {
"type": "string",
"description": "预警种类"
},
"city": {
"type": "string",
"description": "预警城市"
}
}
}
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_10_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"post_code": {
"type": "string",
"description": "邮编，比如上海200000"
},
"phone_code": {
"type": "string",
"description": "电话区号，比如上海021。\n注意邮编和区号必须二选一输入。都输入时，以邮编为准。"
},
"needMoreDay": {
"type": "string",
"description": "是否需要返回7天数据中的后4天。1为返回，0为不返回。"
},
"needIndex": {
"type": "string",
"description": "是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。"
},
"needHourData": {
"type": "string",
"description": "是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态，因此实时数组最大长度为48。每天0点长度初始化为0. 1为需要 0为不"
},
"need3HourForcast": {
"type": "string",
"description": "是否需要当天每3/6小时一次的天气预报列表。1为需要，0为不需要。"
},
"needAlarm": {
"type": "string",
"description": "是否需要天气预警。1为需要，0为不需要。"
}
}
}
}
}
}
}
},
"/9-9": {
"x-pointCode": 9,
"x-mode": "mapping",
"x-read-timeout": 30,
"x-connect-timeout": 30,
"post": {
"summary": "地名--查未来15天预报",
"description": "根据区域code和区域名，获取当前日期至未来15天内的天气预报。因区域名可能存在重名的情况，建议尽量使用区域code来获取数据。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"ret_code": {
"type": "number"
},
"area": {
"type": "string"
},
"areaid": {
"type": "string"
},
"dayList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"0": {
"type": "object",
"properties": {
"night_weather_code": {
"type": "string",
"description": "夜晚天气代号"
},
"day_weather": {
"type": "string",
"description": "白天天气"
},
"night_weather": {
"type": "string",
"description": "夜晚天气"
},
"night_wind_power": {
"type": "string",
"description": "夜晚风力"
},
"day_wind_power": {
"type": "string",
"description": "白天风力"
},
"day_weather_code": {
"type": "string",
"description": "白天天气代号"
},
"daytime": {
"type": "string",
"description": "日期"
},
"day_weather_pic": {
"type": "string",
"description": "白天天气图片"
},
"night_air_temperature": {
"type": "string",
"description": "夜晚气温"
},
"day_air_temperature": {
"type": "string",
"description": "白天气温"
},
"day_wind_direction": {
"type": "string",
"description": "白天风力"
},
"night_weather_pic": {
"type": "string",
"description": "夜晚天气图片"
},
"night_wind_direction": {
"type": "string",
"description": "夜晚风力"
}
}
}
}
}
},
"areaCode": {
"type": "string"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_9_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"areaCode": {
"type": "string",
"description": "地区code. 此参数和area必须输入一个。"
},
"area": {
"type": "string",
"description": "地区名称"
}
}
}
}
}
}
}
},
"/9-8": {
"x-pointCode": 8,
"x-mode": "mapping",
"x-read-timeout": 30,
"x-connect-timeout": 30,
"post": {
"summary": "地名--查询24小时预报",
"description": "根据区域code和区域名，获取24小时的天气预报。区域名可能存在重名的情况，建议尽量使用区域code来获取数据。需要说明的是24小时天气数据是每半小时更新一次。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"ret_code": {
"type": "number",
"description": "0为成功，其他失败"
},
"area": {
"type": "string",
"description": "查到的地区名"
},
"areaid": {
"type": "string",
"description": "查到的地区id"
},
"hourList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"0": {
"type": "object",
"properties": {
"weather_code": {
"type": "string",
"description": "天气代号"
},
"time": {
"type": "string",
"description": "时间"
},
"wind_direction": {
"type": "string",
"description": "风向"
},
"wind_power": {
"type": "string",
"description": "风力"
},
"weather": {
"type": "string",
"description": "天气"
},
"temperature": {
"type": "string",
"description": "气温"
}
}
}
}
},
"description": "24小时预报列表"
},
"areaCode": {
"type": "string",
"description": "查到的地区code"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_8_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"areaCode": {
"type": "string",
"description": "地区code. 此参数和area必须输入一个。"
},
"area": {
"type": "string",
"description": "地区名称"
}
}
}
}
}
}
}
},
"/9-7": {
"x-pointCode": 7,
"x-mode": "mapping",
"x-read-timeout": 30,
"x-connect-timeout": 30,
"post": {
"summary": "名称--查询历史天气",
"description": "根据地区code或名称查询历史天气。每次返回一个地区1个月的数据。历史数据从2011年开始。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"area": {
"type": "string",
"description": "所查询地区名称"
},
"areaid": {
"type": "string",
"description": "所查询地区的id（以后可能会废弃，已areaCode为准）"
},
"list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"0": {
"type": "object",
"properties": {
"max_temperature": {
"type": "string",
"description": "最高温度"
},
"min_temperature": {
"type": "string",
"description": "最低温度"
},
"time": {
"type": "string",
"description": "时间"
},
"weather": {
"type": "string",
"description": "天气"
},
"wind_direction": {
"type": "string",
"description": "风向"
},
"wind_power": {
"type": "string",
"description": "风力"
},
"aqiLevel": {
"type": "string",
"description": "空气质量等级"
},
"aqi": {
"type": "string",
"description": "空气质量指数（若无指数返回-1）"
},
"aqiInfo": {
"type": "string",
"description": "空气质量指数类别"
}
}
}
}
},
"description": "所查月分每日的天气历史记录。"
},
"month": {
"type": "string",
"description": "所查询月份"
},
"ret_code": {
"type": "number",
"description": "0为成功，其他失败"
},
"areaCode": {
"type": "string",
"description": "所查地区code"
},
"startDate": {
"type": "string",
"description": "开始日期（输入参数month有值的情况下，以month为准）"
},
"endDate": {
"type": "string",
"description": "结束日期（输入参数month有值的情况下，以month为准）"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_7_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"areaCode": {
"type": "string",
"description": "地区code"
},
"month": {
"type": "string",
"description": "查询的月份，格式yyyyMM。最早的数据是2011年1月。"
},
"startDate": {
"type": "string",
"description": "查询的开始日期，格式yyyyMMdd。最早的数据是2011年1月1日。"
},
"endDate": {
"type": "string",
"description": "查询的结束日期，格式yyyyMMdd。最早的数据是2011年1月1日。"
},
"area": {
"type": "string",
"description": "地区名称。id和code和名称必须输入其中1个。如果都输入，以code为准"
}
}
}
}
}
}
}
},
"/9-5": {
"x-pointCode": 5,
"x-mode": "mapping",
"x-read-timeout": 20,
"x-connect-timeout": 20,
"post": {
"summary": "坐标--查询天气",
"description": "通过坐标查询对应坐标区域信息，再根据区域查询对应的天气情况。使用场景：手机端通过gps定位查询天气。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "预报发布时间"
},
"cityInfo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"c1": {
"type": "string",
"description": "区域id"
},
"c2": {
"type": "string",
"description": "城市英文名 "
},
"c3": {
"type": "string",
"description": "城市中文名 "
},
"c4": {
"type": "string",
"description": "城市所在市英文名 "
},
"c5": {
"type": "string",
"description": "城市所在市中文名 "
},
"c6": {
"type": "string",
"description": "城市所在省英文名"
},
"c7": {
"type": "string",
"description": "城市所在省中文名"
},
"c8": {
"type": "string",
"description": "城市所在国家英文名 "
},
"c9": {
"type": "string",
"description": "城市所在国家中文名"
},
"c10": {
"type": "string",
"description": "城市级别"
},
"c11": {
"type": "string",
"description": "城市区号 "
},
"c12": {
"type": "string",
"description": "邮编"
},
"longitude": {
"type": "string",
"description": "经度"
},
"latitude": {
"type": "string",
"description": "纬度 "
},
"c15": {
"type": "string",
"description": "海拔"
},
"c16": {
"type": "string",
"description": "雷达站号 "
},
"c17": {
"type": "string",
"description": "时区"
},
"c0": {
"type": "string",
"description": "地区code"
}
}
},
"description": "查询的地区基本资料"
},
"f1": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day_weather": {
"type": "string",
"description": "白天天气"
},
"night_weather": {
"type": "string",
"description": "晚上天气"
},
"day_air_temperature": {
"type": "string",
"description": "白天天气温度(摄氏度) "
},
"night_air_temperature": {
"type": "string",
"description": "晚上天气温度(摄氏度) "
},
"day_wind_direction": {
"type": "string",
"description": "白天风向编号 "
},
"night_wind_direction": {
"type": "string",
"description": "晚上风向编号 "
},
"day_wind_power": {
"type": "string",
"description": "白天风力编号"
},
"night_wind_power": {
"type": "string",
"description": "晚上风力编号"
},
"sun_begin_end": {
"type": "string",
"description": "日出日落时间(中间用|分割) "
},
"index": {
"type": "array",
"items": {
"type": "object",
"properties": {
"beauty": {
"type": "string",
"description": "化妆指数"
},
"clothes": {
"type": "string",
"description": "穿衣指数"
},
"cold": {
"type": "string",
"description": "感冒"
},
"comfort": {
"type": "string",
"description": "舒适"
},
"glass": {
"type": "string",
"description": "太阳镜"
},
"sports": {
"type": "string",
"description": "运动"
},
"travel": {
"type": "string",
"description": "旅游"
},
"uv": {
"type": "string",
"description": "紫外线"
},
"wash_car": {
"type": "string",
"description": "洗车"
},
"aqi": {
"type": "string",
"description": "大气污染"
},
"ac": {
"type": "string",
"description": "空调控制"
},
"ag": {
"type": "string",
"description": "过敏指数"
},
"cl": {
"type": "string",
"description": "晨练指数"
},
"dy": {
"type": "string",
"description": "钓鱼指数"
},
"gj": {
"type": "string",
"description": "逛街指数"
},
"hc": {
"type": "string",
"description": "划船指数"
},
"ls": {
"type": "string",
"description": "晾晒指数"
},
"mf": {
"type": "string",
"description": "美发指数"
},
"nl": {
"type": "string",
"description": "夜生活指数"
},
"pj": {
"type": "string",
"description": "啤酒指数"
},
"pk": {
"type": "string",
"description": "放风筝指数"
},
"yh": {
"type": "string",
"description": "约会指数"
},
"zs": {
"type": "string",
"description": "中暑指数"
},
"xq": {
"type": "string",
"description": "心情指数"
}
}
},
"description": "指数对象"
},
"day": {
"type": "string",
"description": "当前天"
},
"weekday": {
"type": "number",
"description": "星期几"
},
"day_weather_pic": {
"type": "string",
"description": "白天天气图标"
},
"night_weather_pic": {
"type": "string",
"description": "晚上天气图标"
},
"day_weather_code": {
"type": "string",
"description": "白天的天气编码"
},
"night_weather_code": {
"type": "string",
"description": "晚上的天气编码"
},
"air_press": {
"type": "string",
"description": "大气压"
},
"jiangshui": {
"type": "string",
"description": "降水概率"
},
"3hourForcast": {
"type": "array",
"items": {
"type": "object",
"properties": {
"0": {
"type": "object",
"properties": {}
}
}
},
"description": "3小时预报"
},
"ziwaixian": {
"type": "string",
"description": "紫外线"
}
}
},
"description": "今天的天气预报"
},
"f2": {
"type": "string",
"description": "今天+1天的天气预报"
},
"f3": {
"type": "string",
"description": "今天+2天的天气预报"
},
"f4": {
"type": "string",
"description": "今天+3天的天气预报"
},
"f5": {
"type": "string",
"description": "今天+4天的天气预报"
},
"f6": {
"type": "string",
"description": "今天+5天的天气预报"
},
"f7": {
"type": "string",
"description": "今天+6天的天气预报"
},
"now": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气指数，越小越好"
},
"sd": {
"type": "string",
"description": "空气湿度"
},
"temperature": {
"type": "string",
"description": "气温"
},
"temperature_time": {
"type": "string",
"description": "获得气温的时间"
},
"weather": {
"type": "string",
"description": "天气"
},
"weather_pic": {
"type": "string",
"description": "天气小图标"
},
"wind_direction": {
"type": "string",
"description": "风向"
},
"wind_power": {
"type": "string",
"description": "风力"
},
"aqiDetail": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气质量指数，越小越好"
},
"area": {
"type": "string",
"description": "地区"
},
"co": {
"type": "string",
"description": "一氧化碳1小时平均，mg/m3"
},
"no2": {
"type": "string",
"description": "二氧化氮1小时平均,μg/m3"
},
"o3": {
"type": "string",
"description": "臭氧1小时平均，μg/m3"
},
"o3_8h": {
"type": "string",
"description": "臭氧8小时平均，μg/m3"
},
"pm10": {
"type": "string",
"description": "颗粒物（粒径小于等于10μm）1小时平均，μg/m3"
},
"pm2_5": {
"type": "string",
"description": "颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3"
},
"primary_pollutant": {
"type": "string",
"description": "首要污染物"
},
"quality": {
"type": "string",
"description": "空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类"
},
"so2": {
"type": "string",
"description": "二氧化硫1小时平均，μg/m3"
},
"num": {
"type": "string",
"description": "排名。越小越好"
}
}
},
"description": "aqi明细数据"
},
"rain": {
"type": "string",
"description": "降水量(mm)"
}
}
},
"description": "现在实时的天气情况"
},
"hourDataList": {
"type": "array",
"items": {
"type": "object"
},
"description": "每半小时数据的累积数组。当天0点清空重新累积。"
},
"ret_code": {
"type": "number",
"description": "0为成功，其他失败"
},
"alarmList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"signalLevel": {
"type": "string",
"description": "预警等级"
},
"issueContent": {
"type": "string",
"description": "预警详情"
},
"issueTime": {
"type": "string",
"description": "预警时间"
},
"province": {
"type": "string",
"description": "预警省份"
},
"signalType": {
"type": "string",
"description": "预警种类"
},
"city": {
"type": "string",
"description": "预警城市"
}
}
}
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_5_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"lng": {
"type": "string",
"description": "经度值"
},
"lat": {
"type": "string",
"description": "纬度值"
},
"needMoreDay": {
"type": "string",
"description": "是否需要返回7天数据中的后4天。1为返回，0为不返回。"
},
"needIndex": {
"type": "string",
"description": "是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。"
},
"needHourData": {
"type": "string",
"description": "是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态， 因此实时数组最大长度为48。每天0点长度初始化为0.
1为需要
0为不"
},
"need3HourForcast": {
"type": "string",
"description": "是否需要当天每3/6/8小时一次的天气预报列表。1为需要，0为不需要。注意f1是3小时间隔，但f2到f7的间隔可能是6或8小时。"
},
"needAlarm": {
"type": "string",
"description": "是否需要天气预警。1为需要，0为不需要。"
}
},
"required": [
"lng",
"lat"
]
}
}
}
}
}
},
"/9-4": {
"x-pointCode": 4,
"x-mode": "mapping",
"x-read-timeout": 20,
"x-connect-timeout": 20,
"post": {
"summary": "IP--查询天气",
"description": "通过IP地址获取IP对应的区域信息，再根据区域信息获取对应的天气情况",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "预报发布时间"
},
"cityInfo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"c1": {
"type": "string",
"description": "区域id"
},
"c2": {
"type": "string",
"description": "城市英文名 "
},
"c3": {
"type": "string",
"description": "城市中文名 "
},
"c4": {
"type": "string",
"description": "城市所在市英文名 "
},
"c5": {
"type": "string",
"description": "城市所在市中文名 "
},
"c6": {
"type": "string",
"description": "城市所在省英文名"
},
"c7": {
"type": "string",
"description": "城市所在省中文名"
},
"c8": {
"type": "string",
"description": "城市所在国家英文名 "
},
"c9": {
"type": "string",
"description": "城市所在国家中文名"
},
"c10": {
"type": "string",
"description": "城市级别"
},
"c11": {
"type": "string",
"description": "城市区号 "
},
"c12": {
"type": "string",
"description": "邮编"
},
"longitude": {
"type": "string",
"description": "经度"
},
"latitude": {
"type": "string",
"description": "纬度 "
},
"c15": {
"type": "string",
"description": "海拔"
},
"c16": {
"type": "string",
"description": "雷达站号 "
},
"c17": {
"type": "string",
"description": "时区"
},
"c0": {
"type": "string",
"description": "地区code"
}
}
},
"description": "查询的地区基本资料"
},
"f1": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day_weather": {
"type": "string",
"description": "白天天气"
},
"night_weather": {
"type": "string",
"description": "晚上天气"
},
"day_air_temperature": {
"type": "string",
"description": "白天天气温度(摄氏度) "
},
"night_air_temperature": {
"type": "string",
"description": "晚上天气温度(摄氏度) "
},
"day_wind_direction": {
"type": "string",
"description": "白天风向编号 "
},
"night_wind_direction": {
"type": "string",
"description": "晚上风向编号 "
},
"day_wind_power": {
"type": "string",
"description": "白天风力编号"
},
"night_wind_power": {
"type": "string",
"description": "晚上风力编号"
},
"sun_begin_end": {
"type": "string",
"description": "日出日落时间(中间用|分割) "
},
"index": {
"type": "array",
"items": {
"type": "object",
"properties": {
"beauty": {
"type": "string",
"description": "化妆指数"
},
"clothes": {
"type": "string",
"description": "穿衣指数"
},
"cold": {
"type": "string",
"description": "感冒"
},
"comfort": {
"type": "string",
"description": "舒适"
},
"glass": {
"type": "string",
"description": "太阳镜"
},
"sports": {
"type": "string",
"description": "运动"
},
"travel": {
"type": "string",
"description": "旅游"
},
"uv": {
"type": "string",
"description": "紫外线"
},
"wash_car": {
"type": "string",
"description": "洗车"
},
"aqi": {
"type": "string",
"description": "大气污染"
},
"ac": {
"type": "string",
"description": "空调控制"
},
"ag": {
"type": "string",
"description": "过敏指数"
},
"cl": {
"type": "string",
"description": "晨练指数"
},
"dy": {
"type": "string",
"description": "钓鱼指数"
},
"gj": {
"type": "string",
"description": "逛街指数"
},
"hc": {
"type": "string",
"description": "划船指数"
},
"ls": {
"type": "string",
"description": "晾晒指数"
},
"mf": {
"type": "string",
"description": "美发指数"
},
"nl": {
"type": "string",
"description": "夜生活指数"
},
"pj": {
"type": "string",
"description": "啤酒指数"
},
"pk": {
"type": "string",
"description": "放风筝指数"
},
"yh": {
"type": "string",
"description": "约会指数"
},
"zs": {
"type": "string",
"description": "中暑指数"
},
"xq": {
"type": "string",
"description": "心情指数"
}
}
},
"description": "指数对象"
},
"day": {
"type": "string",
"description": "当前天"
},
"weekday": {
"type": "number",
"description": "星期几"
},
"day_weather_pic": {
"type": "string",
"description": "白天天气图标"
},
"night_weather_pic": {
"type": "string",
"description": "晚上天气图标"
},
"day_weather_code": {
"type": "string",
"description": "白天的天气编码"
},
"night_weather_code": {
"type": "string",
"description": "晚上的天气编码"
},
"air_press": {
"type": "string",
"description": "大气压"
},
"jiangshui": {
"type": "string",
"description": "降水概率"
},
"ziwaixian": {
"type": "string",
"description": "紫外线"
}
}
},
"description": "今天的天气预报"
},
"f2": {
"type": "string",
"description": "今天+1天的天气预报"
},
"f3": {
"type": "string",
"description": "今天+2天的天气预报"
},
"f4": {
"type": "string",
"description": "今天+3天的天气预报"
},
"f5": {
"type": "string",
"description": "今天+4天的天气预报"
},
"f6": {
"type": "string",
"description": "今天+5天的天气预报"
},
"f7": {
"type": "string",
"description": "今天+6天的天气预报"
},
"now": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气指数，越小越好"
},
"sd": {
"type": "string",
"description": "空气湿度"
},
"temperature": {
"type": "string",
"description": "气温"
},
"temperature_time": {
"type": "string",
"description": "获得气温的时间"
},
"weather": {
"type": "string",
"description": "天气"
},
"weather_pic": {
"type": "string",
"description": "天气小图标"
},
"wind_direction": {
"type": "string",
"description": "风向"
},
"wind_power": {
"type": "string",
"description": "风力"
},
"aqiDetail": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气质量指数，越小越好"
},
"area": {
"type": "string",
"description": "地区"
},
"co": {
"type": "string",
"description": "一氧化碳1小时平均，mg/m3"
},
"no2": {
"type": "string",
"description": "二氧化氮1小时平均,μg/m3"
},
"o3": {
"type": "string",
"description": "臭氧1小时平均，μg/m3"
},
"o3_8h": {
"type": "string",
"description": "臭氧8小时平均，μg/m3"
},
"pm10": {
"type": "string",
"description": "颗粒物（粒径小于等于10μm）1小时平均，μg/m3"
},
"pm2_5": {
"type": "string",
"description": "颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3"
},
"primary_pollutant": {
"type": "string",
"description": "首要污染物"
},
"quality": {
"type": "string",
"description": "空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类"
},
"so2": {
"type": "string",
"description": "二氧化硫1小时平均，μg/m3"
},
"num": {
"type": "string",
"description": "排名。越小越好"
}
}
},
"description": "aqi明细数据"
},
"rain": {
"type": "string",
"description": "降水量（mm）"
}
}
},
"description": "现在实时的天气情况"
},
"hourDataList": {
"type": "array",
"items": {
"type": "object"
},
"description": "每半小时数据的累积数组。当天0点清空重新累积。"
},
"ret_code": {
"type": "number",
"description": "0为成功，其他失败"
},
"alarmList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"signalLevel": {
"type": "string",
"description": "预警等级"
},
"issueContent": {
"type": "string",
"description": "预警详情"
},
"issueTime": {
"type": "string",
"description": "预警时间"
},
"province": {
"type": "string",
"description": "预警省份"
},
"signalType": {
"type": "string",
"description": "预警种类"
},
"city": {
"type": "string",
"description": "预警城市"
}
}
}
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_4_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"ip": {
"type": "string",
"description": "要查询天气的ip地址，如果不写，则系统取客户端的ip地址。"
},
"needMoreDay": {
"type": "string",
"description": "是否需要返回7天数据中的后4天。1为返回，0为不返回。"
},
"needIndex": {
"type": "string",
"description": "是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。"
},
"needHourData": {
"type": "string",
"description": "是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态，因此实时数组最大长度为48。每天0点长度初始化为0.
1为需要
0为不"
},
"need3HourForcast": {
"type": "string",
"description": "是否需要当天每3/6/8小时一次的天气预报列表。1为需要，0为不需要。注意f1是3小时间隔，但f2到f7的间隔可能是6或8小时。"
},
"needAlarm": {
"type": "string",
"description": "是否需要天气预警。1为需要，0为不需要。"
}
}
}
}
}
}
}
},
"/9-3": {
"x-pointCode": 3,
"x-mode": "mapping",
"x-read-timeout": 20,
"x-connect-timeout": 20,
"post": {
"summary": "地名--查询对应的地名code",
"description": "地名会存在重名的情况，为了避免这一情况的发生，在此提供了地名和区域code的对应关系，然后根据区域code来查询24小时天气、未来15天预报、历史天气等数据。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"ret_code": {
"type": "number",
"description": "0为成功，其他失败"
},
"list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"0": {
"type": "object",
"properties": {
"prov": {
"type": "string",
"description": "城市所在省"
},
"area": {
"type": "string",
"description": "地名"
},
"cityInfo": {
"type": "object",
"properties": {},
"description": "城市信息"
},
"distric": {
"type": "string",
"description": "地区"
},
"areaid": {
"type": "string",
"description": "地名id"
},
"areaCode": {
"type": "string",
"description": "地区code"
}
}
}
}
},
"description": "根据地名模糊匹配出来的城市列表。"
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_3_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"area": {
"type": "string",
"description": "地区名称，如丽江"
}
}
}
}
}
}
}
},
"/9-2": {
"x-pointCode": 2,
"x-mode": "mapping",
"x-read-timeout": 20,
"x-connect-timeout": 20,
"post": {
"summary": "地名--查询天气",
"description": "根据地名，获取地名对应的区域code，再根据区域code取得天气情况。如果存在多个相同的地名，会选取第一条（数据库中默认的区域code的排序顺序取第一条）区域信息作为前提条件来查询天气。",
"responses": {
"200": {
"description": "成功响应",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/ShowapiResEnvelope"
},
{
"type": "object",
"properties": {
"showapi_res_body": {
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "预报发布时间"
},
"cityInfo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"c1": {
"type": "string",
"description": "区域id"
},
"c2": {
"type": "string",
"description": "城市英文名 "
},
"c3": {
"type": "string",
"description": "城市中文名 "
},
"c4": {
"type": "string",
"description": "城市所在市英文名 "
},
"c5": {
"type": "string",
"description": "城市所在市中文名 "
},
"c6": {
"type": "string",
"description": "城市所在省英文名"
},
"c7": {
"type": "string",
"description": "城市所在省中文名"
},
"c8": {
"type": "string",
"description": "城市所在国家英文名 "
},
"c9": {
"type": "string",
"description": "城市所在国家中文名"
},
"c10": {
"type": "string",
"description": "城市级别"
},
"c11": {
"type": "string",
"description": "城市区号 "
},
"c12": {
"type": "string",
"description": "邮编"
},
"longitude": {
"type": "string",
"description": "经度"
},
"latitude": {
"type": "string",
"description": "纬度 "
},
"c15": {
"type": "string",
"description": "海拔"
},
"c16": {
"type": "string",
"description": "雷达站号 "
},
"c17": {
"type": "string",
"description": "时区"
},
"c0": {
"type": "string",
"description": "地区code"
}
}
},
"description": "查询的地区基本资料"
},
"f1": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day_weather": {
"type": "string",
"description": "白天天气"
},
"night_weather": {
"type": "string",
"description": "晚上天气"
},
"day_air_temperature": {
"type": "string",
"description": "白天天气温度(摄氏度) "
},
"night_air_temperature": {
"type": "string",
"description": "晚上天气温度(摄氏度) "
},
"day_wind_direction": {
"type": "string",
"description": "白天风向编号 "
},
"night_wind_direction": {
"type": "string",
"description": "晚上风向编号 "
},
"day_wind_power": {
"type": "string",
"description": "白天风力编号"
},
"night_wind_power": {
"type": "string",
"description": "晚上风力编号"
},
"sun_begin_end": {
"type": "string",
"description": "日出日落时间(中间用|分割) "
},
"index": {
"type": "array",
"items": {
"type": "object",
"properties": {
"beauty": {
"type": "string",
"description": "化妆指数"
},
"clothes": {
"type": "string",
"description": "穿衣指数"
},
"cold": {
"type": "string",
"description": "感冒"
},
"comfort": {
"type": "string",
"description": "舒适"
},
"glass": {
"type": "string",
"description": "太阳镜"
},
"sports": {
"type": "string",
"description": "运动"
},
"travel": {
"type": "string",
"description": "旅游"
},
"uv": {
"type": "string",
"description": "紫外线"
},
"wash_car": {
"type": "string",
"description": "洗车"
},
"aqi": {
"type": "string",
"description": "大气污染"
},
"ac": {
"type": "string",
"description": "空调控制"
},
"ag": {
"type": "string",
"description": "过敏指数"
},
"cl": {
"type": "string",
"description": "晨练指数"
},
"dy": {
"type": "string",
"description": "钓鱼指数"
},
"gj": {
"type": "string",
"description": "逛街指数"
},
"hc": {
"type": "string",
"description": "划船指数"
},
"ls": {
"type": "string",
"description": "晾晒指数"
},
"mf": {
"type": "string",
"description": "美发指数"
},
"nl": {
"type": "string",
"description": "夜生活指数"
},
"pj": {
"type": "string",
"description": "啤酒指数"
},
"pk": {
"type": "string",
"description": "放风筝指数"
},
"yh": {
"type": "string",
"description": "约会指数"
},
"zs": {
"type": "string",
"description": "中暑指数"
},
"xq": {
"type": "string",
"description": "心情指数"
}
}
},
"description": "指数对象"
},
"day": {
"type": "string",
"description": "当前天"
},
"weekday": {
"type": "number",
"description": "星期几"
},
"day_weather_pic": {
"type": "string",
"description": "白天天气图标"
},
"night_weather_pic": {
"type": "string",
"description": "晚上天气图标"
},
"day_weather_code": {
"type": "string",
"description": "白天的天气编码"
},
"night_weather_code": {
"type": "string",
"description": "晚上的天气编码"
},
"air_press": {
"type": "string",
"description": "大气压"
},
"jiangshui": {
"type": "string",
"description": "降水概率"
},
"ziwaixian": {
"type": "string",
"description": "紫外线"
}
}
},
"description": "今天的天气预报"
},
"f2": {
"type": "string",
"description": "今天+1天后的天气预报"
},
"f3": {
"type": "string",
"description": "今天+2天后的天气预报"
},
"f4": {
"type": "string",
"description": "今天+3天后的天气预报"
},
"f5": {
"type": "string",
"description": "今天+4天后的天气预报"
},
"f6": {
"type": "string",
"description": "今天+5天后的天气预报"
},
"f7": {
"type": "string",
"description": "今天+6天后的天气预报"
},
"now": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气指数，越小越好"
},
"sd": {
"type": "string",
"description": "空气湿度"
},
"temperature": {
"type": "string",
"description": "气温"
},
"temperature_time": {
"type": "string",
"description": "获得气温的时间"
},
"weather": {
"type": "string",
"description": "天气"
},
"weather_pic": {
"type": "string",
"description": "天气小图标"
},
"wind_direction": {
"type": "string",
"description": "风向"
},
"wind_power": {
"type": "string",
"description": "风力"
},
"aqiDetail": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aqi": {
"type": "string",
"description": "空气质量指数，越小越好"
},
"area": {
"type": "string",
"description": "地区"
},
"co": {
"type": "string",
"description": "一氧化碳1小时平均，mg/m3"
},
"no2": {
"type": "string",
"description": "二氧化氮1小时平均,μg/m3"
},
"o3": {
"type": "string",
"description": "臭氧1小时平均，μg/m3"
},
"o3_8h": {
"type": "string",
"description": "臭氧8小时平均，μg/m3"
},
"pm10": {
"type": "string",
"description": "颗粒物（粒径小于等于10μm）1小时平均，μg/m3"
},
"pm2_5": {
"type": "string",
"description": "颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3"
},
"primary_pollutant": {
"type": "string",
"description": "首要污染物"
},
"quality": {
"type": "string",
"description": "空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类"
},
"so2": {
"type": "string",
"description": "二氧化硫1小时平均，μg/m3"
},
"num": {
"type": "string",
"description": "排名。越小越好"
}
}
},
"description": "aqi明细数据"
},
"rain": {
"type": "string",
"description": "降水量（mm）"
}
}
},
"description": "现在实时的天气情况"
},
"hourDataList": {
"type": "array",
"items": {
"type": "object"
},
"description": "每半小时数据的累积数组。当天0点清空重新累积。"
},
"ret_code": {
"type": "number",
"description": "0为成功，其他失败"
},
"alarmList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"signalLevel": {
"type": "string",
"description": "预警等级"
},
"issueContent": {
"type": "string",
"description": "预警详情"
},
"issueTime": {
"type": "string",
"description": "预警时间"
},
"province": {
"type": "string",
"description": "预警省份"
},
"signalType": {
"type": "string",
"description": "预警种类"
},
"city": {
"type": "string",
"description": "预警城市"
}
}
}
}
},
"description": "业务返回体"
}
}
}
]
}
}
}
}
},
"operationId": "9_2_POST",
"parameters": [],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"properties": {
"areaCode": {
"type": "string",
"description": "要查询的地区code"
},
"area": {
"type": "string",
"description": "要查询的地区名称。与areaCode两个字段必须输入其中一个。当两者都输入时，系统只取areaCode"
},
"needMoreDay": {
"type": "string",
"description": "是否需要返回7天数据中的后4天。1为返回，0为不返回。"
},
"needIndex": {
"type": "string",
"description": "是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。"
},
"need3HourForcast": {
"type": "string",
"description": "是否需要当天每3/6/8小时一次的天气预报列表。1为需要，0为不需要。注意f1是3小时间隔，但f2到f7的间隔可能是6或8小时。"
},
"needAlarm": {
"type": "string",
"description": "是否需要天气预警。1为需要，0为不需要。"
},
"needHourData": {
"type": "string",
"description": "是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态，因此实时数组最大长度为48。每天0点长度初始化为0.1为需要0为不"
}
}
}
}
}
}
}
}
},
"components": {
"securitySchemes": {
"AppKeyAuth": {
"type": "apiKey",
"in": "query",
"name": "appKey",
"description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp"
}
},
"schemas": {
"ShowapiResEnvelope": {
"type": "object",
"description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）",
"properties": {
"showapi_res_code": {
"type": "integer",
"description": "API 返回的状态码"
},
"showapi_res_error": {
"type": "string",
"description": "API 返回的错误信息"
},
"showapi_res_id": {
"type": "string",
"description": "API 请求的唯一标识"
},
"showapi_fee_num": {
"type": "integer",
"description": "API 调用计费次数"
}
}
}
}
},
"security": [
{
"AppKeyAuth": []
}
],
"externalDocs": {
"url": "https://www.showapi.com/apiGateway/view/9?tab=book"
},
"x-apiCode": "9",
"x-is-own": false,
"x-is-op": true
}