星河API星河 API 观测平台

天气查询

GET 需密钥

查询实时天气与预报。数据源为腾讯天气（免费公开接口），支持当天实况、逐小时预报与多日预报，仅返回天气相关数据。

调用地址

https://api.shurans.cn/api/weather

调用方式

GET

# 请求头携带密钥
Authorization: Bearer <你的密钥>

请求参数

参数必填示例说明
province 必填 四川 省 / 直辖市名，如：四川、上海（≤32 字）
city 必填 成都 城市名，如：成都（≤32 字）
county 可选 成华区 区 / 县名，如：成华区；省略时按市级查询（不要填市名，上游会返回空数据）
scope 可选 hourly 查询范围：observe 当天实况（默认）| hourly 逐小时预报 | daily 多日预报
hours 可选 24 scope=hourly 时返回条数，1–48，默认 24
days 可选 7 scope=daily 时返回天数，1–8，默认 7（从今天起算）

响应示例

{
    "code": 200,
    "message": "ok",
    "data": {
        "location": { "province": "四川", "city": "成都", "county": "成华区" },
        "observe": {
            "weather": "阴",
            "weather_code": "02",
            "degree": 22,
            "humidity": 72,
            "precipitation": 0,
            "pressure": 953,
            "wind_direction": "北风",
            "wind_power": "1-3",
            "update_time": "2026-10-15 18:10"
        },
        "today": { "day_weather": "多云", "night_weather": "阴", "max_degree": 24, "min_degree": 19 },
        "sun": { "sunrise": "07:05", "sunset": "18:33" },
        "alarm": []
    },
    "meta": { "request_id": "7214361835712ec46e74081384fc82be" }
}

响应字段说明

字段说明
code 业务状态码，成功恒为 200
message 状态说明，成功恒为 ok
data.location 查询的省 / 市 / 区县
data.observe 当天实况：天气、气温、湿度、降水量、气压、风向风力、更新时间（scope=observe）
data.today 今日白天 / 夜间天气与最高最低温，上游未覆盖时为 null（scope=observe）
data.sun 今日日出 / 日落时间，上游未覆盖时为 null（scope=observe）
data.alarm 气象预警列表，无预警时空数组（scope=observe）
data.hours[] 逐小时预报：时间、天气、weather_code、气温、风向风力（scope=hourly）
data.days[] 多日预报（从今天起）：日期、白天 / 夜间天气与风力、最高最低温、空气质量（AQI）（scope=daily）
meta.request_id 本次请求的追踪 ID（32 位十六进制），同时随 X-Request-Id 响应头返回

© 2026 星河 API