Weather API Config Guide
⚠️ Important: API Domain Change
QWeather has enabled a new API Host system, and old public domains will stop service:
devapi.qweather.com- Service ends on January 1, 2026api.qweather.com- Service ends on June 1, 2026
Be sure to configure your private API Host to ensure service continuity!
Configuration Steps
Step 1: Register QWeather Account
- Visit the QWeather Developer Platform: https://dev.qweather.com.
- Click "Sign Up" or "Login" in the top-right corner.
- Complete account registration (supports email, phone numbers, etc.).
Step 2: Create App to get API Key
- After logging in, enter the "Console".
- Click "App Management" → "My Apps" in the left menu.
- Click the "Create App" button.
- Fill in the app info:
- App Name: Anything you like, e.g., "Mixstart Weather".
- Select KEY Type: Select "Web API" ⚠️ (Important: Must be Web API).
- Data Encryption: Select "No".
- Subscription Plan: Select "Free Subscription" (1000 calls per day).
- Click "Create".
Step 3: Get API Host
- In the console page, click the avatar in the top-right corner.
- Select "Settings".
- In the "API Host" section, copy your private domain.
- The format is similar to:
abc123.def456.qweatherapi.com.
Step 4: Configure in Mixstart
- Open the Mixstart main window.
- Click the "Settings" icon (⚙️) in the top-right.
- In the settings window, select the "Weather Settings" tab.
- Fill in:
- API Host: Paste your private domain (e.g., abc123.def456.qweatherapi.com).
- API Key: Paste your 32-character API Key.
- Click "Save".
Step 5: Use Weather Widget
- Go to the "Desktop Widgets" category.
- Click "Add Widget".
- Select "Weather" type.
- Configure city name (e.g., "New York", "London", "Tokyo").
- Select temperature unit (Celsius/Fahrenheit).
- Click "Create".
- Click "Push to Desktop".
Features
- ✅ Real-time weather data (temperature, humidity, wind, etc.)
- ✅ Auto-refresh (every 30 minutes)
- ✅ Error prompts and caching mechanism
- ✅ Supports both Chinese and English city names
FAQ
Q: Why does it say "Please configure weather API key first"?
A: You need to configure your QWeather API Key and API Host in settings first.
Q: What if a 404 error occurs?
A: Please check:
- Whether an API Host is configured (Required!).
- Whether the key type is "Web API".
- Whether the API Host format is correct (xxx.xxx.qweatherapi.com).
- Whether the key is complete (32 characters).
Q: What are the limits of the free version?
A: The free version of QWeather provides 1,000 API calls per day, which is perfectly sufficient for personal use. Mixstart uses a 30-minute caching mechanism, so the actual number of calls will be much fewer.
Q: Is my data safe?
A: Completely! The API Key and API Host are only stored in your local configuration files and will not be uploaded to any server.
City Name Support
- Major Global Cities: New York, London, Tokyo, Paris, Berlin, etc.
- Chinese Cities: Beijing, Shanghai, Guangzhou, Shenzhen, etc.
- International Regions: Hong Kong, Macao, Taipei, etc.
- City Name input supports English and Chinese.