- 一个接口是一组接入点，每个接入点有自己的费率
- 资源包过期或用完，会立即失效
- 可购买多个资源包，会自动递延生效串联使用
5
累计调用
80亿+满1元打8折，1024程序员节，2020-10-24至2020-10-31
满1元打8折，双十一 电商节特卖，2020-11-02至2020-11-12
数据来源于国家气象局发布的数据,可根据地区名称、经纬度、IP查询对应地区的天气预报。 包括天气预警、白天晚上的温度、湿度、风速、风力，一氧化碳、二氧化氮等PM 2.5空气质量指数，穿衣、出行、洗车等生活指数。7天天气范围的预报每天更新3次，分别是7:30分，12:00分，18:00分。实时天气情况每30分钟更新1次。15天预报每天更新3次，分别是9:00分,12:00分,19:00分（可延迟10分左右查询）。
让网络数据像水、电一样, 使用容易、自由和便宜
已为3000多家企业提供API服务
非文件上传的POST时，请设置headers['Content-Type'] = 'application/x-www-form-urlencoded',
并把对象形式的数据转成查询字符串
文件上传的POST时，请设置headers['Content-Type'] = 'multipart/form-data'
| 参数名称 | 类型 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|
| showapi_appid | String | 100 | 是 | 易源应用id |
| showapi_sign | String | 698d51a19d8a121ce581499d7b701668 | 是 | 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选【简单密钥方式】,在url后带上showapi_appid和showapi_sign即可 |
| showapi_timestamp | String | 20141114142239 | 否 | 客户端时间。
格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。 |
| showapi_res_gzip | String | 1或0 | 否 | 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 |
| ... | ||||
| 参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
|---|---|---|---|---|---|
| from | String |
5
|
是 |
输入的坐标类型：
1：标准GPS设备获取的角度坐标，国际标准，WGS84坐标系; 2：GPS获取的米制坐标、sogou地图所用坐标; 3：google地图、高徳、soso地图、aliyun地图、mapabc地图和amap地图所用坐标，也称为火星坐标系GCJ02。 4：3中列表地图坐标对应的米制坐标 5：百度地图采用的经纬度坐标，也称为Bd09坐标系。 6：百度地图采用的米制坐标 7：mapbar地图坐标; 8：51地图坐标 |
|
| lng | String |
116.2278
|
是 |
经度值
|
|
| lat | String |
40.242266
|
是 |
纬度值
|
|
| needMoreDay | String |
0
|
否 |
是否需要返回7天数据中的后4天。1为返回，0为不返回。
|
|
| needIndex | String |
0
|
否 |
是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。
|
|
| needHourData | String |
0
|
否 |
是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态， 因此实时数组最大长度为48。每天0点长度初始化为0.
1为需要 0为不 |
|
| need3HourForcast | String |
0
|
否 |
是否需要当天每3/6/8小时一次的天气预报列表。1为需要，0为不需要。注意f1是3小时间隔，但f2到f7的间隔可能是6或8小时。
|
|
| needAlarm | String |
0
|
否 |
是否需要天气预警。1为需要，0为不需要。
|
|
| ... | |||||
以JSON格式返回结果。
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 |
| showapi_res_code | int | 0 |
易源返回标志,0为成功，其他为失败。
0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -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受限 -1014，token权限无效 |
| showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
| showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
| ... | |||
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| time | String |
201203061100
|
预报发布时间
|
| cityInfo | Object[] |
|
查询的地区基本资料
|
| - c1 | String |
101010100
|
区域id
|
| - c2 | String |
beijing
|
城市英文名
|
| - c3 | String |
北京
|
城市中文名
|
| - c4 | String |
beijing
|
城市所在市英文名
|
| - c5 | String |
北京
|
城市所在市中文名
|
| - c6 | String |
beijing
|
城市所在省英文名
|
| - c7 | String |
北京
|
城市所在省中文名
|
| - c8 | String |
china
|
城市所在国家英文名
|
| - c9 | String |
中国
|
城市所在国家中文名
|
| - c10 | String |
1
|
城市级别
|
| - c11 | String |
010
|
城市区号
|
| - c12 | String |
100000
|
邮编
|
| - longitude | String |
116.391
|
经度
|
| - latitude | String |
39.904
|
纬度
|
| - c15 | String |
33
|
海拔
|
| - c16 | String |
AZ9010
|
雷达站号
|
| - c17 | String |
+8
|
时区
|
| - c0 | String |
110000
|
地区code
|
| f1 | Object[] |
|
今天的天气预报
|
| - day_weather | String |
多云
|
白天天气
|
| - night_weather | String |
暴雨
|
晚上天气
|
| - day_air_temperature | String |
26
|
白天天气温度(摄氏度)
|
| - night_air_temperature | String |
12
|
晚上天气温度(摄氏度)
|
| - day_wind_direction | String |
东北风
|
白天风向编号
|
| - night_wind_direction | String |
西北风
|
晚上风向编号
|
| - day_wind_power | String |
3-4级10~17m/h
|
白天风力编号
|
| - night_wind_power | String |
微风<10m/h
|
晚上风力编号
|
| - sun_begin_end | String |
06:44|18:21
|
日出日落时间(中间用|分割)
|
| - index | Object[] |
|
指数对象
|
| - beauty | String |
|
化妆指数
|
| - clothes | String |
|
穿衣指数
|
| - cold | String |
|
感冒
|
| - comfort | String |
|
舒适
|
| - glass | String |
|
太阳镜
|
| - sports | String |
|
运动
|
| - travel | String |
|
旅游
|
| - uv | String |
|
紫外线
|
| - wash_car | String |
|
洗车
|
| - aqi | String |
|
大气污染
|
| - ac | String |
|
空调控制
|
| - ag | String |
|
过敏指数
|
| - cl | String |
|
晨练指数
|
| - dy | String |
|
钓鱼指数
|
| - gj | String |
|
逛街指数
|
| - hc | String |
|
划船指数
|
| - ls | String |
|
晾晒指数
|
| - mf | String |
|
美发指数
|
| - nl | String |
|
夜生活指数
|
| - pj | String |
|
啤酒指数
|
| - pk | String |
|
放风筝指数
|
| - yh | String |
|
约会指数
|
| - zs | String |
|
中暑指数
|
| - xq | String |
|
心情指数
|
| - day | String |
20150627
|
当前天
|
| - weekday | Number |
6
|
星期几
|
| - day_weather_pic | String |
|
白天天气图标
|
| - night_weather_pic | String |
|
晚上天气图标
|
| - day_weather_code | String |
01
|
白天的天气编码
|
| - night_weather_code | String |
02
|
晚上的天气编码
|
| - air_press | String |
|
大气压
|
| - jiangshui | String |
|
降水概率
|
| f2 | String |
|
今天+1天的天气预报
|
| f3 | String |
|
今天+2天的天气预报
|
| f4 | String |
|
今天+3天的天气预报
|
| f5 | String |
|
今天+4天的天气预报
|
| f6 | String |
|
今天+5天的天气预报
|
| f7 | String |
|
今天+6天的天气预报
|
| now | Object[] |
|
现在实时的天气情况
|
| - aqi | String |
65
|
空气指数，越小越好
|
| - sd | String |
56%
|
空气湿度
|
| - temperature | String |
26
|
气温
|
| - temperature_time | String |
15:00
|
获得气温的时间
|
| - weather | String |
阴
|
天气
|
| - weather_pic | String |
http://appimg.showapi.com/images/weather/icon/day/02.png
|
天气小图标
|
| - wind_direction | String |
南风
|
风向
|
| - wind_power | String |
1级
|
风力
|
| - aqiDetail | Object[] |
|
aqi明细数据
|
| - aqi | String |
38
|
空气质量指数，越小越好
|
| - area | String |
昆明
|
地区
|
| - co | String |
0.713
|
一氧化碳1小时平均，mg/m3
|
| - no2 | String |
12
|
二氧化氮1小时平均,μg/m3
|
| - o3 | String |
104
|
臭氧1小时平均，μg/m3
|
| - o3_8h | String |
52
|
臭氧8小时平均，μg/m3
|
| - pm10 | String |
37
|
颗粒物（粒径小于等于10μm）1小时平均，μg/m3
|
| - pm2_5 | String |
19
|
颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3
|
| - primary_pollutant | String |
颗粒物(PM2.5)
|
首要污染物
|
| - quality | String |
优
|
空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
|
| - so2 | String |
13
|
二氧化硫1小时平均，μg/m3
|
| - num | String |
12
|
排名。越小越好
|
| hourDataList | Object[] |
|
每半小时数据的累积数组。当天0点清空重新累积。
|
| ret_code | String |
0
|
0为成功，其他失败
|
| ... | |||
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"cityInfo": {
"c0":"110114",
"c1": "101010700",
"c10": "3",
"c11": "010",
"c12": "102200",
"c15": "80",
"c16": "AZ9010",
"c17": "+8",
"c2": "changping",
"c3": "昌平",
"c4": "beijing",
"c5": "北京",
"c6": "beijing",
"c7": "北京",
"c8": "china",
"c9": "中国",
"latitude": 40.206,
"longitude": 116.165
},
"now": {
"aqi": "71",
"aqiDetail": {
"aqi": "71",
"area": "北京",
"area_code": "beijing",
"co": "0.817",
"no2": "52",
"o3": "33",
"o3_8h": "9",
"pm10": "56",
"pm2_5": "51",
"primary_pollutant": "颗粒物(PM2.5)",
"quality": "良",
"so2": "3"
},
"sd": "70%",
"temperature": "15",
"temperature_time": "18:30",
"weather": "晴",
"weather_pic": "http://appimg.showapi.com/images/weather/icon/day/00.png",
"wind_direction": "北风",
"wind_power": "1级"
},
"f1": {
"air_press": "1008 hPa",
"day": "20151023",
"day_air_temperature": "18",
"day_weather": "晴",
"day_weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
"day_wind_direction": "无持续风向",
"day_wind_power": "微风<10m/h",
"jiangshui": "3%",
"night_air_temperature": "9",
"night_weather": "晴",
"night_weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"night_wind_direction": "无持续风向",
"night_wind_power": "微风<10m/h",
"sun_begin_end": "06:35|17:23",
"weekday": 5,
"ziwaixian": "中等",
"index": {
"beauty": {
"desc": "请选用中性保湿型霜类化妆品。",
"title": "保湿"
},
"clothes": {
"desc": "建议穿薄外套或牛仔裤等服装。",
"title": "较舒适"
},
"cold": {
"desc": "昼夜温差大，易感冒。",
"title": "易发"
},
"comfort": {
"desc": "白天不冷不热，风力不大。",
"title": "舒适"
},
"glass": {
"desc": "白天根据户外光线情况佩戴太阳镜",
"title": "需要"
},
"sports": {
"desc": "户外运动请注意防晒。",
"title": "较适宜"
},
"travel": {
"desc": "天气较好，丝毫不会影响您出行的心情。",
"title": "适宜"
},
"uv": {
"desc": "辐射较弱，涂擦SPF12-15、PA+护肤品。",
"title": "弱"
},
"wash_car": {
"desc": "无雨且风力较小，易保持清洁度。",
"title": "较适宜"
}
},
"alarmList": [
{
"city": "",
"issueContent": "大风蓝色预警:预计23日23时到24日08时:大连、锦州、营口、盘锦、葫芦岛地区陆地偏北风6级,阵风7级;渤海、渤海海峡、黄海北部偏北风7级,阵风8级。大连、丹东、锦州、营口、盘锦、葫芦岛附近海域和航线将受影响,请注意防范。省气象灾害预警中心10月23日16时35分发布",
"issueTime": "2015-10-23 16:40:00",
"province": "辽宁省",
"signalLevel": "蓝色",
"signalType": "大风"
}
],
"3hourForcast": [
{
"hour": "20时-23时 ",
"temperature": "12℃/10℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
},
{
"hour": "23时-02时 ",
"temperature": "10℃/9℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
},
{
"hour": "02时-05时 ",
"temperature": "10℃/9℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
},
{
"hour": "05时-08时 ",
"temperature": "13℃/10℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
}
]
},
"f1": {
"air_press": "1008 hPa",
"day": "20151023",
"day_air_temperature": "18",
"day_weather": "晴",
"day_weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
"day_wind_direction": "无持续风向",
"day_wind_power": "微风<10m/h",
"jiangshui": "3%",
"night_air_temperature": "9",
"night_weather": "晴",
"night_weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"night_wind_direction": "无持续风向",
"night_wind_power": "微风<10m/h",
"sun_begin_end": "06:35|17:23",
"weekday": 5,
"ziwaixian": "中等",
"index": {
"beauty": {
"desc": "请选用中性保湿型霜类化妆品。",
"title": "保湿"
},
"clothes": {
"desc": "建议穿薄外套或牛仔裤等服装。",
"title": "较舒适"
},
"cold": {
"desc": "昼夜温差大，易感冒。",
"title": "易发"
},
"comfort": {
"desc": "白天不冷不热，风力不大。",
"title": "舒适"
},
"glass": {
"desc": "白天根据户外光线情况佩戴太阳镜",
"title": "需要"
},
"sports": {
"desc": "户外运动请注意防晒。",
"title": "较适宜"
},
"travel": {
"desc": "天气较好，丝毫不会影响您出行的心情。",
"title": "适宜"
},
"uv": {
"desc": "辐射较弱，涂擦SPF12-15、PA+护肤品。",
"title": "弱"
},
"wash_car": {
"desc": "无雨且风力较小，易保持清洁度。",
"title": "较适宜"
}
},
"alarmList": [
{
"city": "",
"issueContent": "大风蓝色预警:预计23日23时到24日08时:大连、锦州、营口、盘锦、葫芦岛地区陆地偏北风6级,阵风7级;渤海、渤海海峡、黄海北部偏北风7级,阵风8级。大连、丹东、锦州、营口、盘锦、葫芦岛附近海域和航线将受影响,请注意防范。省气象灾害预警中心10月23日16时35分发布",
"issueTime": "2015-10-23 16:40:00",
"province": "辽宁省",
"signalLevel": "蓝色",
"signalType": "大风"
}
],
"3hourForcast": [
{
"hour": "20时-23时 ",
"temperature": "12℃/10℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
},
{
"hour": "23时-02时 ",
"temperature": "10℃/9℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
},
{
"hour": "02时-05时 ",
"temperature": "10℃/9℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/night/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
},
{
"hour": "05时-08时 ",
"temperature": "13℃/10℃",
"weather": "晴",
"weather_pic": "http://app1.showapi.com/weather/icon/day/00.png",
"wind_direction": "无持续风向",
"wind_power": "微风"
}
]
},
"hourDataList": [
{
"aqi": "53",
"aqiDetail": {},
"sd": "85%",
"temperature": "9",
"temperature_time": "00:00",
"weather": "多云",
"weather_pic": "http://appimg.showapi.com/images/weather/icon/night/01.png",
"wind_direction": "北风",
"wind_power": "1级"
},
{
"aqi": "53",
"aqiDetail": {},
"sd": "81%",
"temperature": "10",
"temperature_time": "00:30",
"weather": "多云",
"weather_pic": "http://appimg.showapi.com/images/weather/icon/night/01.png",
"wind_direction": "北风",
"wind_power": "1级"
}
],
"ret_code": 0,
"time": "20151023180000"
}
}
用户名： showapi
电话： 4009988033
微博： http://www.weibo.com/showapi
签名：
邮箱：
QQ： 3007663665
微信： show_api
客服
