实况天气预报API接口v61

实况天气v61

请求限制：
每日10万次 (可升级，量大请联系客服)

计费方式：
包年/永久

发票：
普票/电子票/专票

立即开通

功能介绍

行政中心5分钟更新一次, 县级市区25分钟更新一次，包含基本天气信息、气象预警、湿度、能见度、气压、日出日落、6大生活指数、pm2.5、pm10、o3、no2、so2、是否需要带口罩、外出适宜、开窗适宜、是否需要打开净化器等，可按地名、城市编号、IP查询。

API文档在线测试此接口

请求方式及url：

请求方式：GET

接口地址：(建议在服务端设置线路地址为动态可修改的)

线路1(推荐)：https://v0.yiketianqi.com/api
线路2：https://yiketianqi.com/api

请求示例

https://v0.yiketianqi.com/api?version=v61&appid=&appsecret=

请求参数说明：

参数名	必选	类型	说明	备注（示例）
appid	是	string	用户appid	注册开发账号
appsecret	是	string	用户appsecret
version	是	string	接口版本标识	固定值: `v61` 每个接口的version值都不一样
cityid	否	string	城市ID	请参考城市ID列表
city	否	string	城市名称	不要带市和区; 如: 青岛、铁西
province	否	string	所在省	如果您担心city重名可传此参数, 不要带省和市; 如: 山东、上海
ip	否	string	IP地址	查询IP所在城市天气
lng	否	String	经度	如: 119.545023 (需额外开通lbs权限, 500/年, 2000/5年, 3000/永久)
lat	否	String	纬度	如: 36.044254
point	否	String	坐标体系	默认百度坐标, 如使用高德坐标, 请传参: gaode
callback	否	string	jsonp参数	如: `jQuery.Callbacks`
vue	否	string	跨域参数	如果您使用的是react、vue、angular请填写值: `1`

备注

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

响应JSON

{
    "cityid":"101120101",
    "date":"2021-04-24",
    "week":"星期六",
    "update_time":"08:29",
    "city":"济南",
    "cityEn":"jinan",
    "country":"中国",
    "countryEn":"China",
    "wea":"阴",
    "wea_img":"yin",
    "tem":"11",
    "tem1":"18",
    "tem2":"11",
    "win":"东风",
    "win_speed":"3级",
    "win_meter":"小于12km/h",
    "humidity":"87%",
    "visibility":"3.9km",
    "pressure":"1001",
    "air":"42",
    "air_pm25":"27",
    "air_level":"优",
    "air_tips":"空气很好，可以外出活动，呼吸新鲜空气，拥抱大自然！",
    "alarm":{
        "alarm_type":"大风",
        "alarm_level":"蓝色",
        "alarm_content":"济南市气象台2021年04月23日09时00分发布大风蓝色预警信号：受冷空气影响，预计23日中午至24日傍晚，我市大部分地区将出现平均风力4～5级阵风7级的偏北风。（预警信息来源：国家预警信息发布中心）"
    },
    "aqi":{
        "update_time":"07:29",
        "cityid":"101120101",
        "city":"济南",
        "cityEn":"jinan",
        "country":"中国",
        "countryEn":"China",
        "air":"42",
        "air_level":"优",
        "air_tips":"空气很好，可以外出活动，呼吸新鲜空气，拥抱大自然！",
        "pm25":"27",
        "pm25_desc":"优",
        "pm10":"42",
        "pm10_desc":"优",
        "o3":"86",
        "o3_desc":"优",
        "no2":"11",
        "no2_desc":"优",
        "so2":"6",
        "so2_desc":"优",
        "co":"1",
        "co_desc":"优",
        "kouzhao":"不用佩戴口罩",
        "yundong":"非常适宜运动",
        "waichu":"适宜外出",
        "kaichuang":"适宜开窗",
        "jinghuaqi":"关闭净化器"
    }
}

示例代码

$ curl "https://v0.yiketianqi.com/api?version=v61&appid=&appsecret="

错误码参考

字段	错误码	说明
errcode	100	该接口有任何异常报错都会返回errcode报错, 并且只有100, 具体报错描述请参考字段：errmsg

{
    "errcode":100,
    "errmsg":"缺少注册参数appid或appsecret"
}