Swift中调用AccuWeather API及解析返回结果的问题排查

Hey there! Let's walk through how to debug your JSON serialization problem and get your AccuWeather API calls working smoothly in Swift.

First: Validate Your Request & Response Status #

Before jumping into parsing, let's confirm your request is actually returning a valid success response. Here's what to check first:

1. Log the HTTP status code to spot obvious errors. AccuWeather returns clear status codes for issues like invalid API keys or missing location data. Add this to your completion handler:

   guard let httpResponse = response as? HTTPURLResponse else {
       print("No valid HTTP response received")
       return
   }
   print("Status Code: \(httpResponse.statusCode)")
   

   • If you see 401: Double-check your API key is correctly included in the apikey query parameter (no typos, and it's active in your AccuWeather dashboard).
   • If you see 404: Verify your location key is valid—you need to fetch this first via AccuWeather's Locations API, not just guess it.

2. Print the raw response as a string to see exactly what's coming back. Sometimes the "JSON" is actually an error message in plain text, which would break serialization. Add this line right after receiving the data:

   if let responseString = String(data: data, encoding: .utf8) {
       print("Raw Response: \(responseString)")
   }
   

   This will reveal if the response is valid JSON, or if it's an error like "Invalid API Key" or "Rate Limit Exceeded".

Debug JSON Serialization Failures #

If your status code is 200 (success) but serialization still fails, use a do-catch block to capture the exact error details:

do {
    let jsonObject = try JSONSerialization.jsonObject(with: data, options: .allowFragments)
    print("Parsed JSON: \(jsonObject)")
} catch {
    print("JSON Serialization Failed: \(error.localizedDescription)")
    print("Full Error Details: \(error)")
}

Common issues here include:

• Accidental typos in your request URL leading to malformed JSON
• Unexpected response structure (like an array instead of a single object)

Better Approach: Use Codable for Type-Safe Parsing #

Instead of JSONSerialization, Swift's Codable protocol is cleaner and safer for parsing structured APIs like AccuWeather. Here's an example for current conditions:

1. Define model structs that match AccuWeather's response structure (check their API docs for full fields):

struct CurrentCondition: Codable {
    let weatherText: String
    let temperature: Temperature
    // Add other fields you need (e.g., isDayTime, weatherIcon)
}

struct Temperature: Codable {
    let metric: TemperatureValue
}

struct TemperatureValue: Codable {
    let value: Double
    let unit: String
}

2. Decode the data using JSONDecoder:

do {
    // Note: AccuWeather's current conditions endpoint returns an array
    let conditions = try JSONDecoder().decode([CurrentCondition].self, from: data)
    print("Current Weather: \(conditions[0].weatherText), Temp: \(conditions[0].temperature.metric.value)°\(conditions[0].temperature.metric.unit)")
} catch {
    print("Decoding Error: \(error)")
}

Final Checks to Rule Out Common Pitfalls #

• Use HTTPS: AccuWeather supports HTTPS, so use https://dataservice.accuweather.com instead of HTTP to avoid ATS (App Transport Security) issues.
• Query Parameters: Ensure your URL includes all required parameters. For current conditions, it should look like:

  https://dataservice.accuweather.com/currentconditions/v1/{LOCATION_KEY}?apikey={YOUR_API_KEY}&details=true
  

• Rate Limits: Free AccuWeather tiers have rate limits. If you hit this, the raw response string will explicitly tell you.

By following these steps, you should quickly identify why your JSON serialization is failing and get your API calls working as expected.

内容的提问来源于stack exchange，提问作者Florian S