天气查询 - API接口详情与文档

请求地址：https://openapi.dwo.cc/api/weather_tx

请求方式：get

请求类型：none

秘钥KEY传参

参数名	参数类型	参数示例	参数说明
ckey	string	SJKHJDBBDGGE	支持通过：headers/query/body(x-www)

Query参数

参数名	必填	类型	说明	示例值
type	否	string	查询天气类型，取值： now[默认] 实时天气预报 future 未来天气预报（默认获取当天和未来3天的天气信息） hours 未来24小时天气预报（起始时间为当前时间的前一个小时）	future
get_md	否	string	未来预报天数，仅在type=future时生效，取值： 0 [默认]当天加未来3天的天气情况 1 当天加未来6天的天气情况	1
added_fields	否	string	附加字段，取值： alarm 预警信息，仅在type=now时生效。 index 生活指数信息，仅在type=future时生效 air 空气质量信息	-
output	否	string	返回格式：支持JSON/JSONP，默认JSON	-
callback	否	string	JSONP方式回调函数	-
adcode	是（二选一）	string	行政区划代码，可支持市级和区/县级	360423
location	是（二选一）	string	位置经纬度，获取坐标所在区县的天气数据	-

响应结果结构

名称	类型	说明
status	integer	0
message	string	Success
request_id	string	4c2513f7fd254ae791bccc01bf9516b5
result	object	包含字段: forecast

接口返回示例

{
  "status": 0,
  "message": "Success",
  "request_id": "a33509abb28f47959870b461485a0326",
  "result": {
    "forecast": [
      {
        "province": "江西省",
        "city": "九江市",
        "district": "武宁县",
        "adcode": 360423,
        "update_time": "2026-03-03 19:05",
        "infos": [
          {
            "date": "2026-03-03",
            "week": "星期二",
            "day": {
              "weather": "多云",
              "temperature": 10,
              "wind_direction": "西北风",
              "wind_power": "微风",
              "humidity": 91
            },
            "night": {
              "weather": "阴",
              "temperature": 8,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 83
            }
          },
          {
            "date": "2026-03-04",
            "week": "星期三",
            "day": {
              "weather": "阴",
              "temperature": 16,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 89
            },
            "night": {
              "weather": "多云",
              "temperature": 8,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 59
            }
          },
          {
            "date": "2026-03-05",
            "week": "星期四",
            "day": {
              "weather": "多云",
              "temperature": 20,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 88
            },
            "night": {
              "weather": "多云",
              "temperature": 9,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 69
            }
          },
          {
            "date": "2026-03-06",
            "week": "星期五",
            "day": {
              "weather": "阴",
              "temperature": 16,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 98
            },
            "night": {
              "weather": "阴",
              "temperature": 8,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 62
            }
          },
          {
            "date": "2026-03-07",
            "week": "星期六",
            "day": {
              "weather": "阴",
              "temperature": 16,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 87
            },
            "night": {
              "weather": "小雨",
              "temperature": 8,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 46
            }
          },
          {
            "date": "2026-03-08",
            "week": "星期日",
            "day": {
              "weather": "小雨",
              "temperature": 16,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 86
            },
            "night": {
              "weather": "小雨",
              "temperature": 8,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 69
            }
          },
          {
            "date": "2026-03-09",
            "week": "星期一",
            "day": {
              "weather": "小雨",
              "temperature": 13,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 94
            },
            "night": {
              "weather": "小雨",
              "temperature": 7,
              "wind_direction": "北风",
              "wind_power": "微风",
              "humidity": 66
            }
          }
        ]
      }
    ]
  }
}

响应码	说明
200	请求成功
203	秘钥错误或不存在
204	服务器错误
211	接口不存在
212	当前接口已下架
213	当前接口正处于审核期
214	API本地文件不存在，请联系管理员检查
215	管理员设置当前接口必须携带ckey请求！
216	付费接口请携带ckey请求！
217	ckey不存在！
218	当前ckey无权限调用此接口，请将此接口添加到ckey调用能力中后重试！
219	访问频率超过限制！请稍后重试！
220	本地API逻辑错误！请联系管理员检查！
221	状态码与管理员配置的状态码不一致，请联系管理员！
222	禁止访问！请联系管理员 (已被加入黑名单)
223	积分不足！请充值后重试
224	余额不足！请充值后重试
225	您已设置仅白名单ip访问！请将当前ip添加到白名单中

启用	参数名	参数值	数据类型	参数说明	操作

Body 类型说明

字节海

快捷入口

热门资讯