ShowAPI,互联网API入口
立即注册

天气预报 官方自营 全部收费

数据来源于国家气象局发布的数据,可根据地区名称、经纬度、IP查询对应地区的天气预报。 包括天气预警、白天晚上的温度、湿度、风速、风力,一氧化碳、二氧化氮等PM 2.5空气质量指数,穿衣、出行、洗车等生活指数。7天天气范围的预报每天更新3次,分别是7:30分,12:00分,18:00分。实时天气情况每30分钟更新1次。

累计调用

52亿+
价格: 0.01元试用

接口说明/ API Explain

数据来源于国家气象局发布的数据,可根据地区名称、经纬度、IP查询对应地区的天气预报。 包括天气预警、白天晚上的温度、湿度、风速、风力,一氧化碳、二氧化氮等PM 2.5空气质量指数,穿衣、出行、洗车等生活指数。7天天气范围的预报每天更新3次,分别是7:30分,12:00分,18:00分。实时天气情况每30分钟更新1次。

接入点说明:
 根据地区id或名称查询历史天气。每次返回一个地区1个月的数据。历史数据从2011年开始。
接口地址: http://route.showapi.com/9-7 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
返回格式: json
请求方式: HTTP协议,支持GET/POST方法。
调用样式及调试工具: 测试工具

查看加密签名方式 请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):展开收起
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数): 展开收起
参数名称 类型 默认值 示例值 必须 描述
areaid String
地区id
area String
北京
地区名称。id和名称必须输入其中1个。如果都输入,以id为准
month String
201601
查询的月份,格式yyyyMM。最早的数据是2011年1月。
...

返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
areaid String
所查询地区的id
area String
所查询地区名称
month String
所查询月份
list WeatherHisItem[]
所查月分每日的天气历史记录。
- time String
20160113
日期
- weather String
晴-多云
天气情况
- max_temperature String
2
最高气温
- min_temperature String
-7
最低气温
- wind_direction String
无持续风向
风向
- wind_power String
微风
风力
ret_code String
0
0为成功,其他失败
...

返回示例/ Return example

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_body": {
		"area": "北京",
		"areaid": "101010100",
		"list": [
			{
				"max_temperature": "2℃",
				"min_temperature": "-7℃",
				"time": "20160113",
				"weather": "晴-多云",
				"wind_direction": "无持续风向",
				"wind_power": "微风"
			},
			{
				"max_temperature": "0℃",
				"min_temperature": "-8℃",
				"time": "20160112",
				"weather": "晴",
				"wind_direction": "无持续风向",
				"wind_power": "微风"
			},
			{
				"max_temperature": "-1℃",
				"min_temperature": "-9℃",
				"time": "20160111",
				"weather": "晴",
				"wind_direction": "无持续风向",
				"wind_power": "微风"
			},
			{
				"max_temperature": "1℃",
				"min_temperature": "-8℃",
				"time": "20160110",
				"weather": "多云-晴",
				"wind_direction": "无持续风向",
				"wind_power": "微风"
			},
			{
				"max_temperature": "3℃",
				"min_temperature": "-6℃",
				"time": "20160109",
				"weather": "晴-多云",
				"wind_direction": "无持续风向",
				"wind_power": "微风"
			},
			{
				"max_temperature": "2℃",
				"min_temperature": "-8℃",
				"time": "20160108",
				"weather": "晴",
				"wind_direction": "北风~无持续风向",
				"wind_power": "3-4级~微风"
			},
			{
				"max_temperature": "2℃",
				"min_temperature": "-7℃",
				"time": "20160107",
				"weather": "晴",
				"wind_direction": "北风~无持续风向",
				"wind_power": "3-4级~微风"
			},
			{
				"max_temperature": "3℃",
				"min_temperature": "-6℃",
				"time": "20160106",
				"weather": "晴",
				"wind_direction": "北风",
				"wind_power": "3-4级"
			},
			{
				"max_temperature": "1℃",
				"min_temperature": "-7℃",
				"time": "20160105",
				"weather": "晴",
				"wind_direction": "北风~无持续风向",
				"wind_power": "3-4级~微风"
			},
			{
				"max_temperature": "2℃",
				"min_temperature": "-6℃",
				"time": "20160104",
				"weather": "多云-晴",
				"wind_direction": "北风~无持续风向",
				"wind_power": "3-4级~微风"
			},
			{
				"max_temperature": "3℃",
				"min_temperature": "-4℃",
				"time": "20160103",
				"weather": "霾-多云",
				"wind_direction": "无持续风向~北风",
				"wind_power": "微风~3-4级"
			},
			{
				"max_temperature": "6℃",
				"min_temperature": "-4℃",
				"time": "20160102",
				"weather": "霾-雾",
				"wind_direction": "无持续风向",
				"wind_power": "微风"
			},
			{
				"max_temperature": "5℃",
				"min_temperature": "-4℃",
				"time": "20160101",
				"weather": "霾",
				"wind_direction": "无持续风向",
				"wind_power": "微风"
			}
		],
		"month": "201601",
		"ret_code": 0
	}
}