一、前置准备
注册与开通服务
访问万维易源官网（https://www.showapi.com/）注册账号并实名认证。
找到 “天气预报” API 并开通，获取 showapi_appid（应用 ID）与 showapi_sign（密钥），在控制台可查看。
接口选择（常用）
接口用途 接口地址 核心参数 备注
实时 + 7 天预报 https://route.showapi.com/92 area（地名）、showapi_appid、showapi_sign 支持 3 小时粒度预报，数据 30 分钟更新一次
未来 40 天预报 https://route.showapi.com/9-12 area（地名）、showapi_appid、showapi_sign 每天 3 次更新，建议优先用 areaCode 避免重名
地名转区域 ID https://route.showapi.com/9-3 area（地名）、showapi_appid、showapi_sign 解决地名重名问题，获取 areaCode 后再查天气
二、调用流程与示例
- 核心请求参数（通用）
参数 是否必填 说明
showapi_appid 是 应用唯一标识，控制台获取
showapi_sign 是 接口密钥，用于签名验证
area 是 地名（如 “北京”“上海”），与 areaCode 二选一，重名时取第一条记录
need3HourForcast 否 1 = 需要 3 小时预报，0 = 不需要（默认 0）
needAlarm 否 1 = 需要天气预警，0 = 不需要（默认 0） - 调用示例（以实时 + 7 天预报为例）
请求 URL（替换占位符）：
plaintext
https://route.showapi.com/92?showapi_appid=你的APPID&showapi_sign=你的密钥&area=北京&need3HourForcast=1
发送 GET 请求（可通过 Postman、curl 或代码实现）。
curl 命令示例：
bash
运行
curl "https://route.showapi.com/92?showapi_appid=xxx&showapi_sign=xxx&area=北京" - 响应结果解析（JSON 格式）
成功时 showapi_res_code 为 0，核心数据在 showapi_res_body 中：
json
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"now": { "temp": "2℃", "weather": "晴", "wind_direction": "北风" },
"f1": { "day_weather": "晴", "day_temp": "8℃", "night_temp": "-3℃" },
"f2": { ... }
}
}
now：当前天气实况（温度、天气、风向等）。
f1~f7：未来 7 天预报（日 / 夜天气、温度等）。
若 need3HourForcast=1，会返回 hourly_forecast 数组，包含每 3 小时预报。
三、代码实现（Python 示例）
python
运行
import requests
def get_weather_by_area(area, appid, sign):
url = "https://route.showapi.com/92"
params = {
"showapi_appid": appid,
"showapi_sign": sign,
"area": area,
"need3HourForcast": 1
}
response = requests.get(url, params=params)
result = response.json()
if result["showapi_res_code"] == 0:
return result["showapi_res_body"]
else:
raise Exception(f"请求失败：{result['showapi_res_error']}")
使用示例
if name == "main":
APPID = "你的APPID"
SIGN = "你的密钥"
weather_data = get_weather_by_area("上海", APPID, SIGN)
print("当前温度：", weather_data["now"]["temp"])
print("今日天气：", weather_data["f1"]["day_weather"])
四、常见问题与注意事项
地名重名问题：优先调用 9-3 接口获取 areaCode，再用 areaCode 查询天气，避免结果错误。
签名错误：检查 showapi_appid 与 showapi_sign 是否匹配，密钥是否泄露。
频率限制：不同套餐有调用次数限制，超出会返回 403 或 503，可在控制台查看配额。
数据更新：实时天气 30 分钟更新，7 天预报每天 3 次更新，40 天预报每天 3 次更新。
五、扩展建议
缓存机制：对同一地名的查询结果缓存 10–30 分钟，减少接口调用次数。
异常处理：捕获网络错误、响应超时、参数错误等，返回友好提示。
重名处理：调用 9-3 接口获取所有匹配的 areaCode，让用户选择正确区域后再查询天气。