全国天气预报接口文档说明

全国天气预报接口地址

https://api.ip138.com/weather/

https://api.ip138.com/weather/

示例1(Linux命令行下执行)

请求方式

get

参数说明:

1. code string 行政区划代码 (可选)

2. ip string iP地址 (可选,默认为请求iP,仅当用户没有提供行政区划代码时有效)

3. callback string 回调函数(可选,默认为空)

4. token string 购买服务后会提供(必填)

5. type int 查询类型 1:今日天气 7:一周天气 (默认今日天气)

6. style int 天气icon样式 1|2|3

样式1

样式2

样式3

curl "https://api.ip138.com/weather/?code=350229&callback=find&type=1" -H "token:cc87f3c77747bccbaaee35006da1ebb65e0bad57"

示例2

参数说明:

1. code string 行政区划代码 (可选)

2. ip string iP地址 (可选,默认为请求iP,仅当用户没有提供行政区划代码时有效)

3. callback string 回调函数(可选,默认为空)

4. token string 购买服务后会提供(必填)

5. type int 查询类型 1:今日天气 7:一周天气 (默认今日天气)

6. style int 天气icon样式 1|2|3

https://api.ip138.com/weather/?code=350229&type=1&callback=find&token=cc87f3c77747bccbaaee35006da1ebb65e0bad57

示例3(js引入推荐方案)

参数说明:

1. code string 行政区划代码 (可选)

2. ip string iP地址 (可选,默认为请求iP,仅当用户没有提供行政区划代码时有效)

3. callback string 回调函数 当前参数仅为jsonp格式数据提供(可选，默认为空)

4. type int 查询类型 1:今日天气 7:一周天气 (默认今日天气)

5. style int 天气icon样式 1|2|3

6. time string 时间戳(必填)

7. oid string 购买服务后提供(必填)

8. mid string 购买服务后提供(必填)

9. sign string 签名验证 (签名算法:md5("time=" + time + "&token=" + token))(必填)

https://api.ip138.com/weather/?code=350229&callback=find&time=20170102&oid={oid}&mid={mid}&sign=签名算法

选择获取行政区划代码：

复制

行政区划代码列表说明

JSONP返回示例

说明：ret 值为 ok 时 返回data查询结果数据 为err时返回msg错误信息

{

"ret": "ok", // ret 值为 ok 时 返回 data 数据 为err时返回msg数据

"code": "350103", // 行政区划代码

"province":"福建省",

"city":"福州市",

"area":"台江区",

"data": [

time:"14:20", //更新时间

dayIcon:"http://p.abcache.com/ip138/image/tianqi1/d00.png", //天气图标

dayWeather:"晴转多云", //白天天气

dayTemp:"18", //白天温度

dayWind:"微风", //白天风力

"nightIcon":"http://p.abcache.com/ip138/image/tianqi1/n01.png", //天气图标

nightWeather:"中度霾转多云", //夜晚天气

nightTemp:"9", //夜晚温度

nightWind:"微风", //夜晚风力

temp"9", //实时温度

"Icon":"http://p.abcache.com/ip138/image/tianqi1/d00.png" //天气图标

weather:"多云", //实时天气

wind:"北风1级", //实时风力

humidity:"82" //湿度

pm25:11 //pm

]

}

查询token使用情况

URL

https://api.ip138.com/status/

请求方式

get

参数

1. token `string`

示例

https://api.ip138.com/status/?token=cc87f3c77747bccbaaee35006da1ebb65e0bad57

响应

{

"ret":"ok",

"data":{

"reqs":10, //当前小时请求数

"hour":3000, //当前小时购买次数

"package":19767 //配额次数

}

}