天气信息

GET

今日/未来一周天气信息

https://api.aiys.net/api/tianqi
https://api.aiys.net/api/tianqi/?region=%E4%B8%8A%E6%B5%B7

请求参数

将 Key 放到 Header 中使用 Authorization 请求头,按 Bearer Token 方式传递
Authorization:Bearer YOUR_API_KEY

接口指标

QPS 上限
0.33次/秒
平均响应时间
0ms
今日调用量
0
累计调用量
35

请求示例

Shell
JavaScript
Python
PHP
Java
Go
C#
Ruby
curl -X GET 'https://api.aiys.net/api/tianqi?region=${城市名}&type=${选项值}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

返回示例

{
  "code": 200,
  "message": "获取成功",
  "data": {
    "location": {
      "name": "上海上海",
      "province": "上海省",
      "city": "上海市",
      "county": ""
    },
    "weather": {
      "condition": "阴",
      "condition_code": "02",
      "temperature": 7,
      "humidity": 71,
      "pressure": 1028,
      "precipitation": 0,
      "wind_direction": "西风",
      "wind_power": "3-4",
      "weather_icon": "https://mat1.gtimg.com/qqcdn/xw/tianqi/bigIcon/heiye/02.png",
      "weather_colors": [
        "#546481",
        "#8993AF",
        "#DBC2A9"
      ],
      "updated": "2026-03-03 21:25:00",
      "updated_at": 1772544300000
    },
    "air_quality": {
      "aqi": 24,
      "level": 1,
      "quality": "优",
      "pm25": 14,
      "pm10": 16,
      "co": 0.4,
      "no2": 11,
      "o3": 74,
      "so2": 5,
      "rank": 61,
      "total_cities": 375,
      "updated": "2026-03-03 21:00:00",
      "updated_at": 1772542800000
    },
    "sunrise": {
      "sunrise": "2026-03-03 06:19:00",
      "sunrise_at": 1772489940000,
      "sunrise_desc": "06:19",
      "sunset": "2026-03-03 17:53:00",
      "sunset_at": 1772531580000,
      "sunset_desc": "17:53"
    },
    "life_indices": [
      {
        "key": "airconditioner",
        "name": "空调开启",
        "level": "较少开启",
        "description": "您将感到很舒适,一般不需要开启空调。"
      },
      {
        "key": "allergy",
        "name": "过敏",
        "level": "较易发",
        "description": "天气条件较易诱发过敏,宜穿长衣长裤,远离过敏源,适当佩戴眼镜和口罩。"
      },
      {
        "key": "carwash",
        "name": "洗车",
        "level": "不适宜",
        "description": "将有降水,不宜洗车,建议至少1天后再洗车。"
      },
      {
        "key": "chill",
        "name": "风寒",
        "level": "冷",
        "description": "感觉有点冷,室外活动要穿厚实一点,年老体弱者要适当注意保暖。"
      },
      {
        "key": "clothes",
        "name": "穿衣",
        "level": "冷",
        "description": "天气冷,建议着棉服、羽绒服、皮夹克加羊毛衫等冬季服装。年老体弱者宜着厚棉衣、冬大衣或厚羽绒服。"
      },
      {
        "key": "cold",
        "name": "感冒",
        "level": "少发",
        "description": "各项气象条件适宜,无明显降温过程,发生感冒机率较低。"
      },
      {
        "key": "comfort",
        "name": "舒适度",
        "level": "较不舒适",
        "description": "白天天气阴沉,您会感觉偏冷,不很舒适,请注意添加衣物,以防感冒。"
      },
      {
        "key": "diffusion",
        "name": "空气污染扩散条件",
        "level": "较差",
        "description": "气象条件较不利于空气污染物稀释、扩散和清除。"
      },
      {
        "key": "dry",
        "name": "路况",
        "level": "干燥",
        "description": "阴天,路面比较干燥,路况较好。"
      },
      {
        "key": "drying",
        "name": "晾晒",
        "level": "不太适宜",
        "description": "天气阴沉,不利于水分的迅速蒸发,不太适宜晾晒。若需要晾晒,请尽量选择通风的地点。"
      },
      {
        "key": "fish",
        "name": "钓鱼",
        "level": "较适宜",
        "description": "较适合垂钓,但天气稍凉,会对垂钓产生一定的影响。"
      },
      {
        "key": "heatstroke",
        "name": "中暑",
        "level": "无中暑风险",
        "description": "天气舒适,令人神清气爽的一天,不用担心中暑的困扰。"
      },
      {
        "key": "makeup",
        "name": "化妆",
        "level": "保湿",
        "description": "皮肤易缺水,用润唇膏后再抹口红,用保湿型霜类化妆品。"
      },
      {
        "key": "mood",
        "name": "心情",
        "level": "差",
        "description": "天气阴冷,感觉压抑,不妨给自己的心情放个假,把所有的烦恼丢之脑后,把所有的爱记在心上,整个人便会变得轻松而有力量。"
      },
      {
        "key": "morning",
        "name": "晨练",
        "level": "较适宜",
        "description": "早晨气象条件较适宜晨练,但天气阴沉,风力稍大,请选择合适的地点晨练。"
      },
      {
        "key": "sports",
        "name": "运动",
        "level": "较适宜",
        "description": "天气较好,无雨水困扰,较适宜进行各种运动,但因天气凉,在户外运动请注意增减衣物。"
      },
      {
        "key": "sunglasses",
        "name": "太阳镜",
        "level": "必要",
        "description": "白天天空阴沉,但太阳辐射较强,建议佩戴透射比1级且标注UV380-UV400的浅色太阳镜"
      },
      {
        "key": "sunscreen",
        "name": "防晒",
        "level": "弱",
        "description": "属弱紫外辐射天气,长期在户外,建议涂擦SPF在8-12之间的防晒护肤品。"
      },
      {
        "key": "tourism",
        "name": "旅游",
        "level": "适宜",
        "description": "天气较好,气温稍低,会感觉稍微有点凉,不过也是个好天气哦。适宜旅游,可不要错过机会呦!"
      },
      {
        "key": "traffic",
        "name": "交通",
        "level": "良好",
        "description": "阴天,路面干燥,交通气象条件良好,车辆可以正常行驶。"
      },
      {
        "key": "ultraviolet",
        "name": "紫外线强度",
        "level": "最弱",
        "description": "属弱紫外线辐射天气,无需特别防护。若长期在户外,建议涂擦SPF在8-12之间的防晒护肤品。"
      },
      {
        "key": "umbrella",
        "name": "雨伞",
        "level": "不带伞",
        "description": "阴天,但降水概率很低,因此您在出门的时候无须带雨伞。"
      }
    ],
    "alerts": []
  },
  "request_id": "82eeba669f033c208f897379"
}