开发指南

新用户可测试2000次 比某度更精准、及时,请进入气象台网站对比数据

免费7日天气接口


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

请求方式及url:

  • 请求方式:GET

  • 线路1(推荐)https://v0.yiketianqi.com/free/week

  • 线路2:https://yiketianqi.com/free/week

请求示例

https://www.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 风力等级

收费方案

地区权限 请求限制 使用方案(报价为不开票价格) 发票
全国所有市区县 每日500次(不固定) 个人免费
全国所有市区县 每日2万次 100/一年(最低) 400/五年(最低) 780/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日5万次 200/一年(最低) 800/五年(最低) 1560/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日10万次 400/一年(最低) 1600/五年(最低) 3120/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日20万次 1000/一年(最低) 4000/五年(最低) 7800/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日50万次 2500/一年(最低) 10000/五年(最低) 19500/永久(最低) 可开普票/电子票/专票
全国所有市区县 每日百万~千万次 联系客服开通独享版本,最低12800/年 可开普票/电子票/专票