天气查询

按城市行政区划编码查询实时天气或天气预报

POST/api/service/weather

接口说明

天气查询接口根据城市行政区划编码返回实时天气或未来天气预报。传入 base 获取实时天气，传入 all 获取天气预报。

请求方式POST
支持地区中国大陆
坐标系GCJ02（火星坐标系）

认证方式

所有 API 请求均需通过 HTTP Authorization 请求头携带 Bearer Token 进行身份验证。 Token 可在控制台的「团队设置 → API 密钥」中创建和管理。

// 请求头示例
Authorization: Bearer <YOUR_API_KEY>

Token 属于密钥凭证，请勿提交到代码仓库或公开渠道。建议由服务端调用 API，避免在前端直接暴露 Token。

请求参数

POST/api/service/weather
参数名类型必填说明
cityinteger必填城市行政区划编码，如北京市为 110000
extensionsstring必填查询类型：base=实时天气，all=天气预报

返回字段

成功响应result: 1HTTP 200
字段名类型说明
resultinteger成功标识，1 为成功
livesarray实时天气列表，extensions=base 时返回
└provincestring省份名称
└citystring城市名称
└adcodestring城市行政区划编码
└weatherstring天气现象
└temperaturestring实时气温，单位摄氏度
└winddirectionstring风向
└windpowerstring风力级别
└humiditystring空气湿度
└reporttimestring数据发布时间
forecastsarray天气预报列表，extensions=all 时返回
└provincestring省份名称
└citystring城市名称
└adcodestring城市行政区划编码
└reporttimestring预报发布时间
└castsarray逐日预报列表，含 date、week、dayweather、nightweather、daytemp、nighttemp、daywind、nightwind、daypower、nightpower

代码示例

请求示例
JavaScript
fetch('https://lts.maiyun.net/api/service/weather', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        city: 110000,
        extensions: 'base',
    }),
})
    .then(r => r.json())
    .then(data => {
        console.log(data.lives[0]?.weather);
    });
返回示例（成功）
JSON
{
    "result": 1,
    "lives": [
        {
            "province": "北京",
            "city": "北京市",
            "adcode": "110000",
            "weather": "晴",
            "temperature": "20",
            "winddirection": "北",
            "windpower": "≤3",
            "humidity": "38",
            "reporttime": "2026-08-08 14:00:00"
        }
    ],
    "forecasts": []
}

错误码

错误码描述
-1参数错误：city 字段缺失或不是城市行政区划编码
-2参数错误：extensions 仅支持 base 或 all
-3天气服务暂不可用，请稍后重试
-10额度不足，请充值后重试
-400未提供授权信息，请检查 Authorization 请求头
-401Token 不存在或已过期，请重新获取
-402关联的团队账号不存在
-429超出 QPS 限制，请适当降低请求频率后重试
-21 ~ -24服务内部错误，请稍后重试

当请求失败时，接口将返回对应的 result 值（≤ 0）及错误描述字符串。 其中 -400 及以下为通用鉴权错误，其余为当前接口特有错误。