开发指南

发布api对接文章到CSDN可联系客服领取10万次请求次数, 感谢您的支持

免费7日天气接口 (仅限个人用户)


包含基本天气、温度、风力风向等,可按地名、城市编号、IP查询。
支持最多30个城市ID同时查询。

收费方案

地区权限 请求限制 使用方案 发票
全国所有市区县 每日300次左右 个人免费使用3个月
全国所有市区县 每日2万次 100/一年 350/五年 600/永久 可开普票/电子票
全国所有市区县 每日5万次 200/一年 700/五年 1200/永久 可开普票/电子票
全国所有市区县 每日10万次 400/一年 1400/五年 2400/永久 可开普票/电子票
全国所有市区县 每日20万次 1000/一年 3500/五年 6000/永久 可开普票/电子票/专票
全国所有市区县 每日50万次 2500/一年 8750/五年 15000/永久 可开普票/电子票/专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本,最低8800/年 可开普票/电子票/专票

请求方式及url:

  • 请求方式:GET

  • 线路1(推荐)http://v1.yiketianqi.com/free/week

请求示例

http://v1.yiketianqi.com/free/week?unescape=1&appid=&appsecret=

请求参数说明:

参数名 必选 类型 说明 备注(示例)
appid string 用户appid 注册开发账号
appsecret string 用户appsecret
cityid string 城市ID 请参考 城市ID列表
如果您想查询多个城市(最多30个),请用英文逗号隔开, 如:cityid=101120101,101120201,101050101
city string 城市名称 不要带市和区, 支持市区县, 不支持乡镇级别; 如: 青岛、铁西
ip string IP地址 查询IP所在城市天气
callback string jsonp参数 如: jQuery.Callbacks
vue string 跨域参数 如果您使用的是react、vue、angular请填写值: 1
unescape Int 是否转义中文 如果您希望json不被unicode, 直接输出中文, 请传此参数: 1

备注

cityid、city和ip参数3选一提交,如果不传,默认返回当前ip城市天气,cityid优先级最高。

响应JSON

{
    "cityid":"101120101",
    "city":"济南",
    "update_time":"2020-04-21 17:24:11",
    "data":[
        {
            "date":"2020-04-21",
            "wea":"晴",
            "wea_img":"qing",
            "tem_day":"17",
            "tem_night":"4",
            "win":"北风",
            "win_speed":"3-4级"
        },
        {
            "date":"2020-04-22",
            "wea":"晴",
            "wea_img":"qing",
            "tem_day":"15",
            "tem_night":"4",
            "win":"北风",
            "win_speed":"3-4级"
        },
        {
            "date":"2020-04-23",
            "wea":"晴",
            "wea_img":"qing",
            "tem_day":"17",
            "tem_night":"8",
            "win":"北风",
            "win_speed":"3-4级"
        },
        {
            "date":"2020-04-24",
            "wea":"晴",
            "wea_img":"qing",
            "tem_day":"20",
            "tem_night":"10",
            "win":"西南风",
            "win_speed":"4-5级"
        },
        {
            "date":"2020-04-25",
            "wea":"晴",
            "wea_img":"qing",
            "tem_day":"21",
            "tem_night":"11",
            "win":"东北风",
            "win_speed":"4-5级转3-4级"
        },
        {
            "date":"2020-04-26",
            "wea":"多云",
            "wea_img":"yun",
            "tem_day":"21",
            "tem_night":"11",
            "win":"南风",
            "win_speed":"<3级转3-4级"
        },
        {
            "date":"2020-04-27",
            "wea":"晴",
            "wea_img":"qing",
            "tem_day":"15",
            "tem_night":"13",
            "win":"东风",
            "win_speed":"3-4级转<3级"
        }
    ]
}

响应参数说明

参数名 类型 说明 备注
cityid String 城市ID
city String 城市名称
update_time String 更新时间
date String 预报日期
wea String 天气情况
wea_img String 天气对应图标 固定9种类型(您也可以根据wea字段自己处理):
xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
tem_day String 白天温度(高温)
tem_night String 白天温度(低温)
win String 风向
win_speed String 风力等级