天气预报API是提供未来天气预报数据的一个API调用接口,通过此接口可以获取一个城市的温度、、湿度、以及阴、晴、云、雾、风、霜、雪、雨、雷、电等气候信息,从而应用到自己编写的程序中。
挖数据API接口:
Api文档:
子接口:
实时天气预报查询
获取城市名及代码
接口地址:https://登录后显示/api/74/187(支持:http/https)
返回格式:json,xml
请求方式:GET,POST
POST请求需要设置Header头:Content-Type:application/x-www-form-urlencoded;charset=utf-8
请求说明:
名称
必填
类型
说明
示例参数另存
appid
是
String
应用ID,在后台我的应用查看或者添加
1
format
否
String
返回数据格式类型,每个接口已经说明支持返回格式:json,xml
json
sign
是
String
2.使用Hash验证方式,直接跟上密钥即可。
通过我的应用里面修改验证方式
52a9dbe274a5c537bbf7a53e2d66c09f
time
否
String
请求时传递的当前服务器时间戳
1545829466
wtr_id
是
String
可以是城市名称(厦门)、城市ID(101230201)、城市名全拼
返回参数说明:
名称
必填
类型
说明
示例参数另存
codeid
否
Integer
状态码,返回10000状态都会进行计费。具体说明可查看状态码说明
10000
curtime
否
String
当前服务器时间戳
1565941300
message
否
String
请求状态说明
操作成功!
retdata
否
Array
回数据集合,可能是数据、对象或者字符串
wr_15day
否
Array
今天以及未来14天天气情况
wr_air
否
String
空气质量
wr_airquality
否
String
wr_aqi
否
String
空气质量指数,范围值请参考检测网空气质量新准
wr_aqi_pm25
否
String
空气质量指数,范围值请参考检测网空气质量新准
40
wr_city
否
String
城市ID,从这个接口【获取城市名及代码】获取
101230201
wr_cityname
否
String
中文名称
厦门
wr_date
否
String
预报时间
20190830
wr_fc24hour
否
Array
24小时天气预报,仅7天内
wr_hour
否
String
小时
2时
wr_limitnumber
否
String
汽车限号
wr_nameen
否
String
城市拼音或者英文名
xiamen
wr_njd
否
String
能见度
15.55km
wr_qy
否
String
气压
985
wr_rain
否
String
当前降雨量(毫米)
0.0
wr_rain24h
否
String
24小时降雨量
0
wr_richu
否
String
日出时间
05:47
wr_riluo
否
String
日落时间
18:28
wr_sd
否
String
空气温度
68%
wr_temp
否
String
当前温度
26
wr_tempf
否
String
华氏温度
89
wr_time
否
String
预报时间
15:20
wr_today
否
Array
当前天气数据
wr_wd
否
String
风向及等级
南风3级转西南风3级
wr_wdcode
否
Array
风向代码,当出现转变风向时,两代码不一致,后面为转变之后的代码风向代码说明
wr_wde
否
String
风向英文缩写
SE
wr_weather
否
String
天气天气图标
雨
wr_weathercode
否
Array
天气代码,当出现天气出现变化时,两个代码不一致,后面为转变之后的天气代码天气代码
wr_weathere
否
String
英文天气
Overcast
wr_ws
否
String
风速等级
2级
wr_wscode
否
Array
风速代码,当出现转变风速时,两代码不一致,后面为转变之后的代码风速代码说明
wr_wse
否
String
风速
12km/h
状态码说明:
状态码
说明
10000
返回成功
10001
appid必须指定,可以我的应用里面查看
10002
sign值必须指定,加密规则请前往帮助中心查看
10003
sign值验证不通过,加密规则请前往帮助中心查看
10004
时差不能超过10分钟,可以不传递这个参数,注意时间戳单位是秒
10005
appid错误,请检查appid值,前往会员中心-我的应用查看或添加
10006
当前IP地址未授权,请前往用户中心-我的应用添加ip{@info}
10007
应用被禁用,请联系客服处理
10008
应用内没有该接口,请到我的应用里面添加这个接口
10009
api接口不存在
10010
您没有添加该api接口
10011
api已经到期
10012
没有订购任何api,请前往购买后再操作
10013
该接口已经暂停使用
10014
未知的错误,可以联系客服处理
10015
参数个数错误
10019
{@info}
10017
time必须是整型
10018
次数不足
10020
子接口不存在,可能已经被关闭
10021
服务器发生错误
10022
帐户余额不足,请充值!
10023
订单提交成功,等待回调结果
10024
调试模式数据
10025
查无数据
请求示例:
$method='GET';//请求方式GET,POST$secretType='MD5';//验证方式MD5,Hash通过后台我的应用去修改$api_url='https://登录后显示/api/74/187';$appid='应用id';//在后台我的应用查看;$secret='应用密钥';//在后台我的应用查看;$data=array('appid'='1','format'='json','time'='1545829466','wtr_id'='101030100',);$data['appid']=$appid;$data['time']=time();//当前服务器时间if('MD5'==$secretType){ksort($data);//按照键名对数组排序,为数组值保留原来的键。$md5String='';foreach($dataas$key=$val){if(strlen($val)0){//过滤空值$md5String.=$key.$val;}}$secret=md5($md5String.$secret);}$data['sign']=$secret;if('GET'==$method){$sUrl=$api_url.'?'.http_build_query($data);//把数据转换成url参数形式,a=bc=de=f$result=file_get_contents($sUrl);}else{$header=['Content-Type:application/x-www-form-urlencoded;charset=utf-8'];$ch=curl_init();if(is_array($data))$data=http_build_query($data);curl_setopt($ch,CURLOPT_URL,$api_url);curl_setopt($ch,CURLOPT_HTTPHEADER,$header);curl_setopt($ch,CURLOPT_POST,true);//POSTcurl_setopt($ch,CURLOPT_POSTFIELDS,$data);curl_setopt($ch,CURLOPT_AUTOREFERER,true);curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE);curl_setopt($ch,CURLOPT_ENCODING,'gzip,deflate');$result=curl_exec($ch);}$result=json_decode($result,true);print_r($result);现在越来越多的企业开始使用挖数据提供的天气预报api接口,好用是一方面,功能强大是另一方面,最重要的是大家对挖数据平台的信任和厚爱,相信在不久的将来,天气预报API一定能够给广大用户带来良好、满意的体验!