• 73
  • 23438
  • 708

天气预报

weather.com 免费 支持HTTPS

全国天气预报,生活指数、实况、PM2.5等信息

  • 免费会员100次/天
  • 高级会员500次/天
  • 钻石会员无限次/天

免费 (根据会员等级不同,每日可调用次数不同)

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://op.juhe.cn/onebox/weather/query
返回格式:json/xml
请求方式:http get/post
请求示例:http://op.juhe.cn/onebox/weather/query?cityname=%E6%B8%A9%E5%B7%9E&key=您申请的KEY
接口备注:根据城市查询天气,未来5天、生活指数、PM2.5

请求参数说明:

名称 必填 类型 说明
  cityname string 要查询的城市,如:温州、上海、北京,需要utf8 urlencode
  key string 在个人中心->我的数据,接口名称上方查看
  dtype string 返回数据的格式,xml或json,默认json

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集

JSON返回示例:

{
    "reason": "查询成功",
    "result": {
        "data": {
            "realtime": {
                "city_code": "101210701",
                "city_name": "温州",     /*城市*/
                "date": "2014-10-15",  /*日期*/
                "time": "09:00:00",     /*更新时间*/
                "week": 3,
                "moon": "九月廿二",
                "dataUptime": 1413337811,
                "weather": {    /*当前实况天气*/
                    "temperature": "19",     /*温度*/
                    "humidity": "54",     /*湿度*/
                    "info": "雾",
                    "img": "18" /*18是雾这种天气所对应的图片的ID,每种天气的图片需要您自己设计,或者请阅读
 https://www.juhe.cn/docs/api/id/39/aid/117*/
                },
                "wind": {
                    "direct": "北风",
                    "power": "1级",
                    "offset": null,
                    "windspeed": null
                }
            },
            "life": {     /*生活指数*/
                "date": "2014-10-15",
                "info": {
                    "chuanyi": [     /*穿衣指数*/
                        "较舒适",
                        "建议着薄外套或牛仔衫裤等服装。年老体弱者宜着夹克衫、薄毛衣等。昼夜温差较大,注意适当增减衣服。"
                    ],
                    "ganmao": [    /*感冒指数*/
                        "较易发",
                        "昼夜温差较大,较易发生感冒,请适当增减衣服。体质较弱的朋友请注意防护。"
                    ],
                    "kongtiao": [   /*空调指数*/
                        "较少开启",
                        "您将感到很舒适,一般不需要开启空调。"
                    ],
                    "wuran": [     /*污染指数*/
                        "良",
                        "气象条件有利于空气污染物稀释、扩散和清除,可在室外正常活动。"
                    ],
                    "xiche": [     /*洗车指数*/
                        "较适宜",
                        "较适宜洗车,未来一天无雨,风力较小,擦洗一新的汽车至少能保持一天。"
                    ],
                    "yundong": [     /*运动指数*/
                        "较适宜",
                        "天气较好,但风力较大,推荐您进行室内运动,若在户外运动请注意防风。"
                    ],
                    "ziwaixian": [   /*紫外线*/
                        "中等",
                        "属中等强度紫外线辐射天气,外出时建议涂擦SPF高于15、PA+的防晒护肤品,戴帽子、太阳镜。"
                    ]
                }
            },
            "weather": [   /*未来几天天气预报*/
                {
                    "date": "2014-10-15",
                    "info": {
                        "day": [     /*白天天气*/
                            "0",     /*天气ID*/
                            "晴",     /*天气*/
                            "24",     /*高温*/
                            "东北风",     /*风向*/
                            "3-4 级"      /*风力*/
                        ],
                        "night": [    /*夜间天气*/
                            "0",
                            "晴",
                            "13",
                            "东北风",
                            "3-4 级"
                        ]
                    },
                    "week": "三",
                    "nongli": "九月廿二"
                },
                {
                    "date": "2014-10-16",
                    "info": {
                        "dawn": [
                            "0",
                            "晴",
                            "13",
                            "东北风",
                            "3-4 级"
                        ],
                        "day": [
                            "0",
                            "晴",
                            "25",
                            "东北风",
                            "3-4 级"
                        ],
                        "night": [
                            "1",
                            "多云",
                            "15",
                            "东北风",
                            "3-4 级"
                        ]
                    },
                    "week": "四",
                    "nongli": "九月廿三"
                },
                {
                    "date": "2014-10-17",
                    "info": {
                        "dawn": [
                            "1",
                            "多云",
                            "15",
                            "东北风",
                            "3-4 级"
                        ],
                        "day": [
                            "1",
                            "多云",
                            "26",
                            "东北风",
                            "3-4 级"
                        ],
                        "night": [
                            "1",
                            "多云",
                            "16",
                            "东北风",
                            "3-4 级"
                        ]
                    },
                    "week": "五",
                    "nongli": "九月廿四"
                },
                {
                    "date": "2014-10-18",
                    "info": {
                        "dawn": [
                            "1",
                            "多云",
                            "16",
                            "东北风",
                            "3-4 级"
                        ],
                        "day": [
                            "1",
                            "多云",
                            "26",
                            "东风",
                            "3-4 级"
                        ],
                        "night": [
                            "1",
                            "多云",
                            "18",
                            "东风",
                            "3-4 级"
                        ]
                    },
                    "week": "六",
                    "nongli": "九月廿五"
                },
                {
                    "date": "2014-10-19",
                    "info": {
                        "dawn": [
                            "1",
                            "多云",
                            "18",
                            "东风",
                            "3-4 级"
                        ],
                        "day": [
                            "1",
                            "多云",
                            "27",
                            "东风",
                            "3-4 级"
                        ],
                        "night": [
                            "1",
                            "多云",
                            "19",
                            "东南风",
                            "3-4 级"
                        ]
                    },
                    "week": "日",
                    "nongli": "九月廿六"
                },
                {
                    "date": "2014-10-20",
                    "info": {
                        "dawn": [
                            "1",
                            "多云",
                            "19",
                            "东南风",
                            "3-4 级"
                        ],
                        "day": [
                            "1",
                            "多云",
                            "27",
                            "东南风",
                            "3-4 级"
                        ],
                        "night": [
                            "2",
                            "阴",
                            "18",
                            "南风",
                            "3-4 级"
                        ]
                    },
                    "week": "一",
                    "nongli": "九月廿七"
                },
                {
                    "date": "2014-10-21",
                    "info": {
                        "dawn": [
                            "2",
                            "阴",
                            "18",
                            "南风",
                            "3-4 级"
                        ],
                        "day": [
                            "1",
                            "多云",
                            "26",
                            "东北风",
                            "3-4 级"
                        ],
                        "night": [
                            "2",
                            "阴",
                            "17",
                            "",
                            "微风"
                        ]
                    },
                    "week": "二",
                    "nongli": "九月廿八"
                }
            ],
            "pm25": {    /*PM2.5*/
                "key": "Wenzhou",
                "show_desc": 0,
                "pm25": {
                    "curPm": "97",
                    "pm25": "72",
                    "pm10": "97",
                    "level": 2,
                    "quality": "良",
                    "des": "可以接受的,除极少数对某种污染物特别敏感的人以外,对公众健康没有危害。"
                },
                "dateTime": "2014年10月15日09时",
                "cityName": "温州"
            },
            "date": null,
            "isForeign": 0
        }
    },
    "error_code": 0
}

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

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

系统级错误码参照:

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

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

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

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1539617139

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 400-8827-715
  在线客服QQ: 800076065

猜你喜欢

现在注册,百款接口免费测试

免费注册