天气 API 配置指南

⚠️ 重要通知：API域名变更

和风天气已启用新的API Host系统，旧的公共域名将停止服务：

• devapi.qweather.com - 将于 2026年1月1日 停止服务
• api.qweather.com - 将于 2026年6月1日 停止服务

请务必配置专属的API Host以确保服务持续可用！

配置步骤

第一步：注册和风天气账号

1. 访问和风天气开发平台：https://dev.qweather.com
2. 点击右上角「注册」或「登录」
3. 完成账号注册（支持邮箱、手机号等方式）

第二步：创建应用获取API Key

1. 登录后，进入「控制台」
2. 点击左侧菜单「应用管理」→「我的应用」
3. 点击「创建应用」按钮
4. 填写应用信息：
   • 应用名称：随意填写，如"Mixstart天气"
   • 选择KEY类型：选择「Web API」⚠️（重要：必须是Web API）
   • 是否数据加密：选择「否」
   • 订阅计划：选择「免费订阅」（每天1000次调用）
5. 点击「创建」

第三步：获取API Host

1. 在控制台页面，点击右上角头像
2. 选择「设置」
3. 在「API Host」部分，复制你的专属域名
4. 格式类似：abc123.def456.qweatherapi.com

第四步：在Mixstart中配置

1. 打开Mixstart主窗口
2. 点击右上角的「设置」图标（⚙️）
3. 在设置窗口中选择「天气设置」标签
4. 依次填入：
   • API Host：粘贴专属域名（如 abc123.def456.qweatherapi.com）
   • API密钥：粘贴32位的API Key
5. 点击「保存」

第五步：使用天气小组件

1. 进入「桌面推送」分类
2. 点击「添加小组件」
3. 选择「天气」类型
4. 配置城市名称（如"北京"、"上海"、"深圳"等）
5. 选择温度单位（摄氏度/华氏度）
6. 点击「创建」
7. 点击「推送到桌面」

功能特性

• ✅ 实时天气数据（温度、湿度、风力等）
• ✅ 自动刷新（每30分钟）
• ✅ 错误提示和缓存机制
• ✅ 支持中英文城市名称

常见问题

Q: 为什么显示"请先配置天气API密钥"？

A: 需要先在设置中配置和风天气API Key和API Host。

Q: 出现404错误怎么办？

A: 请检查：

• 是否配置了API Host（必填！）
• 密钥类型是否为「Web API」
• API Host格式是否正确（xxx.xxx.qweatherapi.com）
• 密钥是否完整（32位字符）

Q: 免费版有什么限制？

A: 和风天气免费版每天提供1000次API调用，对于个人使用完全够用。Mixstart使用了30分钟缓存机制，实际调用次数会更少。

Q: 数据安全吗？

A: 完全安全！API Key和API Host仅存储在您的本地配置文件中，不会上传到任何服务器。

城市名称支持

• 直辖市：北京、上海、天津、重庆
• 省会城市：广州、深圳、杭州、南京、武汉等
• 地级市：苏州、温州、宁波、青岛等
• 英文名称：Beijing、Shanghai、Guangzhou等
• 特殊地区：香港（Hong Kong）、澳门（Macao）、台北（Taipei）