加载接口文档…
1.6万
累计调用
150ms
平均响应
99.45%
服务可用性
3,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 1,000 次 · QPS 5
登录免费
当前方案每日 3,000 次 · QPS 5
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/moji-weather/raw.md接口请求地址
https://v1.apizero.cn/api/moji-weather
接口请求方式
GET
请求参数格式
URL QUERY
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/moji-weather?city=%E5%8C%97%E4%BA%AC&id=33
接口信息备注
缺省模式：按城市名或 internal_id 查询实况，返回实况/未来7天/24h/AQI/预警/生活指数。city 与 id 二选一。文档示例为北京真实抓取（预报序列已截断）。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| city | string | 可选 · 城市中文名（如「北京」「杭州」）；与 id 二选一 · 示例：北京 |
| id | integer | 可选 · 城市 internal_id（可先调城市搜索）；与 city 二选一 · 示例：33 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| city | object | 城市信息：id / name / parent / pinyin / timezone |
| condition | object | 实况：温度、体感、湿度、气压、风力风向、紫外线、日出日落等 |
| aqi | object | 空气质量指数与等级 |
| forecast_day | array | 未来约 7 天逐日预报 |
| forecast_hour | array | 未来约 24 小时逐时预报 |
| index | array | 生活指数（穿衣、运动等） |
| alert | array | 气象预警列表 |
| summary | string | 一句话天气摘要 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"city": {
"id": 33,
"name": "北京市",
"brief": "北京市",
"parent": "北京市",
"pinyin": "beijingshi",
"timezone": 8
},
"condition": {
"icon": 31,
"condition": "多云",
"temperature": 27,
"real_feel": 30,
"humidity": 88,
"pressure": 999,
"wind_level": 3,
"wind_dir": "南风",
"uvi": "最弱",
"sun_rise": 1785445920000,
"sun_set": 1785497400000,
"lunar_date": "丙午年六月十八",
"dew_point": 23,
"updatetime": 1785441252000,
"tips": "今天有雨||今天有雨，略微偏热，注意衣物变化。",
"wind_speed": 3,
"special_weather": 1,
"wind_speeds": 3.69,
"is_port": 0,
"warn_icon": "",
"warn_title": "",
"warn_desc": "",
"warn_url": "",
"weather_push": "北京市，今天雷阵雨☔，24~32℃，西南风2级，空气 优，这两天空气都不错。雷雨天气，出行注意安全。",
"condition_id": 82,
"wind_direction_id": 9,
"weather_code": 2,
"bg_code": 2,
"warn_id": 0,
"comfort_id": 6
},
"aqi": {
"value": 36,
"level": 1,
"description": "优",
"updatetime": 1785438000000
},
"forecast_day": [
{
"condition_id_day": 4,
"condition_id_night": 31,
"condition_day": "雷阵雨",
"condition_night": "多云",
"temp_day": 33,
"temp_night": 26,
"icon_day": "3",
"icon_night": "3",
"wind_dir_day": "南风",
"wind_dir_night": "南风",
"sun_rise": 1785359460000,
"sun_set": 1785411060000,
"predict_date": 1785340830000,
"wind_level_day": 4,
"wind_level_night": 4,
"wind_speed_day_real": 4.4,
"wind_speed_night_real": 4.4,
"lunar_date": "丙午年六月十七",
"aqi_desc_short": "优",
"aqi_level": 1,
"aqi_value": 32,
"aqi_desc": "优",
"uvi": "中等",
"humidity": 61,
"pressure": 1003
},
{
"condition_id_day": 4,
"condition_id_night": 4,
"condition_day": "雷阵雨",
"condition_night": "雷阵雨",
"temp_day": 32,
"temp_night": 24,
"icon_day": "2",
"icon_night": "2",
"wind_dir_day": "南风",
"wind_dir_night": "西南风",
"sun_rise": 1785445920000,
"sun_set": 1785497400000,
"predict_date": 1785427230000,
"wind_level_day": 2,
"wind_level_night": 2,
"wind_speed_day_real": 2.4,
"wind_speed_night_real": 2.4,
"lunar_date": "丙午年六月十八",
"aqi_desc_short": "优",
"aqi_level": 1,
"aqi_value": 36,
"aqi_desc": "优",
"uvi": "弱",
"humidity": 75,
"pressure": 1002
},
{
"condition_id_day": 4,
"condition_id_night": 4,
"condition_day": "雷阵雨",
"condition_night": "雷阵雨",
"temp_day": 32,
"temp_night": 25,
"icon_day": "2",
"icon_night": "1",
"wind_dir_day": "南风",
"wind_dir_night": "东南风",
"sun_rise": 1785532380000,
"sun_set": 1785583740000,
"predict_date": 1785513630000,
"wind_level_day": 2,
"wind_level_night": 0,
"wind_speed_day_real": 2.4,
"wind_speed_night_real": 0.9,
"lunar_date": "丙午年六月十九",
"aqi_desc_short": "良",
"aqi_level": 2,
"aqi_value": 60,
"aqi_desc": "良",
"uvi": "弱",
"humidity": 77,
"pressure": 1001
}
],
"forecast_hour": [
{
"condition": "多云",
"temperature": 27,
"real_feel": 29,
"humidity": 88,
"wind_speed": "10.116",
"wind_dir": "南风",
"wind_level": "0",
"predict_hour": 1785438000000,
"aqi_value": 36,
"aqi_level": 1,
"aqi_desc": "优",
"comfort_tip": "潮湿",
"wind_text": "微风",
"comfort_tip_2": "适宜",
"uvi_text": "较低"
},
{
"condition": "多云",
"temperature": 27,
"real_feel": 29,
"humidity": 88,
"wind_speed": "13",
"wind_dir": "南风",
"wind_level": "0",
"predict_hour": 1785441600000,
"aqi_value": 38,
"aqi_level": 1,
"aqi_desc": "优",
"comfort_tip": "潮湿",
"wind_text": "微风",
"comfort_tip_2": "适宜",
"uvi_text": "较低"
},
{
"condition": "多云",
"temperature": 26,
"real_feel": 29,
"humidity": 89,
"wind_speed": "7.2",
"wind_dir": "南风",
"wind_level": "0",
"predict_hour": 1785445200000,
"aqi_value": 41,
"aqi_level": 1,
"aqi_desc": "优",
"comfort_tip": "潮湿",
"wind_text": "微风",
"comfort_tip_2": "适宜",
"uvi_text": "较低"
}
],
"index": [
{
"name": "限行",
"status": "尾号",
"level": 1,
"url": "$1/?indexid=1&cityid=33&appshare=1",
"desc": "",
"extra": "5, 0",
"type": 0
},
{
"name": "六月十八",
"status": "万年历",
"level": 2,
"url": "https://html5.moji.com/nb/wnlh5/index.html?channel=speed",
"desc": "$0/index/lunar_v6.png",
"extra": "",
"type": 0
},
{
"name": "闷热",
"status": "穿衣",
"level": 20,
"url": "$1/?indexid=20&cityid=33&appshare=1",
"desc": "$0/index/dress_v6.png",
"extra": "潮湿闷热，衣物排汗透气，手帕擦汗环保时尚，不建议在露天场所逛街。",
"type": 2
}
],
"alert": [],
"updatetime": 1785443154731,
"summary": "北京市，多云，27℃，南风3级，空气优。",
"_cached": true,
"_disclaimer": "数据由墨迹天气提供，仅供参考，不构成专业气象建议；不应用于农业、保险、航运、防灾等决策场景。详细免责声明见 marketplace 详情页。"
},
"request_id": "ms7yrw773bba2d1a",
"tips": "极数本源 · https://apizero.cn"
}