接口文档
请求示例
返回示例
在线调试
请求地址示例
请求参数
根据传入位置，将参数放入 Query、Body 或 Header。
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|---|---|---|---|---|---|---|
city | 城市名称 | query | 可选 | — | — | 传入城市名称 例如：海淀区、滕州市、济南市天桥区 |
location_id | 城市id | query | 可选 | — | — | 传入需要查询的城市ID，可在https://cdn.xxapi.cn/weather/location.html和https://cdn.xxapi.cn/weather/location.sql中查看 |
Authorization | Bearer <access_key> | header | 必填 | Bearer <access_key> | — | 请登录后前往控制面板查询 API Key |
Authorization 请求头请登录后前往控制面板查询 API Key
请求示例
选择开发语言，复制示例并替换为实际参数。
Shell
12
curl --request GET 'https://v2.xxapi.cn/api/weather?city=&location_id=' \
--header 'Authorization: Bearer <access_key>'返回示例
以下为接口配置的示例，实际内容以调用结果为准。
响应内容
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127
{
"code": 200,
"msg": "数据请求成功",
"data": {
"city": {
"ADCode": 370481,
// 行政区划代码（国家标准行政区划码）
"Adm1NameZH": "山东省",
// 一级行政区（省）中文名
"Adm2NameZH": "枣庄市",
// 二级行政区（地级市）中文名
"CityZHNorm": "枣庄",
// 规范化城市中文名
"Latitude": 35.0885,
// 纬度
"LocationID": 101121405,
// 城市 LocationID（用于天气查询的唯一标识）
"LocationNameEN": "Tengzhou",
// 城市英文名
"LocationNameZH": "滕州",
// 城市中文名
"Longitude": 117.1621,
// 经度
"NameZHNorm": "滕州",
// 规范化地区中文名
"ProvZHNorm": "山东"
// 规范化省份中文名
},
"data": [
{
"cloud": "0",
// 云量，百分比数值（0–100），可能为空
"fxDate": "2026-01-08",
// 预报日期（YYYY-MM-DD）
"humidity": "68",
// 相对湿度，百分比数值
"iconDay": "https://cdn.xxapi.cn/weather/icons/100.svg",
// 预报白天天气状况的图标（URL），另请参考天气图标项目
"iconNight": "https://cdn.xxapi.cn/weather/icons/151.svg",
// 预报夜间天气状况的图标（URL）
"moonPhase": "亏凸月",
// 月相名称
"moonPhaseIcon": "https://cdn.xxapi.cn/weather/icons/805.svg",
// 月相图标（URL）
"moonrise": "22:32",
// 当天月升时间，可能为空
"moonset": "10:32",
// 当天月落时间，可能为空
"precip": "0.0",
// 预报当天总降水量，单位：毫米
"pressure": "1011",
// 大气压强，单位：百帕（hPa）
"sunrise": "07:21",
// 日出时间，在高纬度地区可能为空
"sunset": "17:16",
// 日落时间，在高纬度地区可能为空
"tempMax": "8",
// 预报当天最高气温，单位：摄氏度
"tempMin": "-3",
// 预报当天最低气温，单位：摄氏度
"textDay": "晴",
// 预报白天天气状况文字描述
"textNight": "多云",
// 预报夜间天气状况文字描述
"uvIndex": "3",
// 紫外线强度指数
"vis": "25",
// 能见度，单位：公里
"wind360Day": "180",
// 预报白天风向 360° 角度值
"wind360Night": "180",
// 预报夜间风向 360° 角度值
"windDirDay": "南风",
// 预报白天风向（文字描述）
"windDirNight": "南风",
// 预报夜间风向（文字描述）
"windScaleDay": "1-3",
// 预报白天风力等级
"windScaleNight": "1-3",
// 预报夜间风力等级
"windSpeedDay": "16",
// 预报白天风速，单位：公里/小时
"windSpeedNight": "16"
// 预报夜间风速，单位：公里/小时
}
]
},
"request_id": "b926151c50d23872e3d2bc28"
}