聚合数据

天气预报

  • 数据类型: 应用开发
  • 接口状态: 正常
  • 已连接App的数量: 36207
  • 描述: 查询天气情况:温度、湿度、AQI、天气、风向等

接口地址: http://apis.juhe.cn/simpleWeather/query

支持格式: JSON

请求方式: HTTP GET/POST

请求示例: http://apis.juhe.cn/simpleWeather/query?city=%E8%8B%8F%E5%B7%9E&key=

请求参数:

名称 类型 必填 说明
city string 要查询的城市名称/id,城市名称如:温州、上海、北京,需要utf8 urlencode
key string 在个人中心->我的数据,接口名称上方查看

返回字段:

名称 类型 说明
error_code int 返回码,0为查询成功
reason string 返回说明
result string 返回结果集
- - -
realtime - 当前天气详情情况
info string 天气情况,如:晴、多云
wid string 天气标识id,可参考小接口2
temperature string 温度,可能为空
humidity string 湿度,可能为空
direct string 风向,可能为空
power string 风力,可能为空
aqi string 空气质量指数,可能为空
- - -
future - 近5天天气情况
date string 日期
temperature string 温度,最低温/最高温
weather string 天气情况
direct string 风向

JSON返回示例:

{
    "reason": "查询成功",
    "result": {
        "city": "苏州",
        "realtime": {
            "temperature": "4",
            "humidity": "82",
            "info": "阴",
            "wid": "02",
            "direct": "西北风",
            "power": "3级",
            "aqi": "80"
        },
        "future": [
            {
                "date": "2019-02-22",
                "temperature": "1/7℃",
                "weather": "小雨转多云",
                "wid": {
                    "day": "07",
                    "night": "01"
                },
                "direct": "北风转西北风"
            },
            {
                "date": "2019-02-23",
                "temperature": "2/11℃",
                "weather": "多云转阴",
                "wid": {
                    "day": "01",
                    "night": "02"
                },
                "direct": "北风转东北风"
            },
            {
                "date": "2019-02-24",
                "temperature": "6/12℃",
                "weather": "多云",
                "wid": {
                    "day": "01",
                    "night": "01"
                },
                "direct": "东北风转北风"
            },
            {
                "date": "2019-02-25",
                "temperature": "5/12℃",
                "weather": "小雨转多云",
                "wid": {
                    "day": "07",
                    "night": "01"
                },
                "direct": "东北风"
            },
            {
                "date": "2019-02-26",
                "temperature": "5/11℃",
                "weather": "多云转小雨",
                "wid": {
                    "day": "01",
                    "night": "07"
                },
                "direct": "东北风"
            }
        ]
    },
    "error_code": 0
}

XML返回示例:


          

备注:通过城市名称或城市ID查询天气预报情况

服务级错误码参照(error_code):

错误码 说明
207301 错误的查询城市名
207302 查询不到该城市的相关信息
207303 网络错误,请重试

系统级错误码参照:

错误码 说明
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10007 未知的请求源
10008 被禁止的IP
10009 被禁止的KEY
10011 当前IP请求超过限制
10012 请求超过次数限制
10013 测试KEY超过请求限制
10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失)
10020 接口维护
10021 接口停用

错误码格式说明(示例:200201):

2 002 01
服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

其他相关内容:

内容 详细
接口测试 API测试工具
技术支持 info@juhe.cn
联系电话 0512-62391880
QQ交流群 264591694
在线客服QQ 1794844675
商务合作QQ 603866358