POST公开天气生活指数天气预报旧版vv1

天气(旧版)

迁移自旧 Weather:按国内地区名查实时天气与生活指数(数据源天气网 d1.weather.com.cn),返回温度、天气、风向风速、预警、实况与 30 项生活指数。

/api/weather
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

迁移自旧 Weather:按国内地区名查实时天气与生活指数(数据源天气网 d1.weather.com.cn),返回温度、天气、风向风速、预警、实况与 30 项生活指数。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
0stringtype 的旧别名(旧代码 $this->get(['type', 0]))
city*string国内地区名,可带省/市/区/县后缀,例如「北京市朝阳区」「广东深圳」
typestring兼容旧返回格式参数(text/json),新平台统一返回 JSON

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "city": "北京市朝阳区"
}

返回示例

response.json
{
  "code": 1,
  "data": {
    "city": "北京",
    "temp": "12",
    "time": "2026-11-14 22: 40",
    "wind": "南风",
    "tempn": "5",
    "living": [
      {
        "name": "路况指数",
        "tips": "路面较干燥,注意行车安全。",
        "index": "干燥"
      }
    ],
    "current": {
      "city": "北京",
      "temp": "11.2",
      "image": "data:image/png;base64,<图标>",
      "weather": "晴",
      "cityEnglish": "beijing"
    },
    "warning": {},
    "weather": "晴",
    "windSpeed": "<3级",
    "cityEnglish": "beijing"
  },
  "message": "地区:北京\n天气:晴\n风向:南风\n风速:2级\n能见度:20km\n空气指数:62\n更新时间:11月14日(星期六) 22: 40"
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →