Error Code

When an API request fails, you will receive the corresponding error information. This document describes the error codes and error messages for the QWeather API.

NOTE: You should correct the error properly, and when an error occurs, please temporarily stop the request and troubleshoot it. You should not continuously send out error requests, otherwise these error requests look like a DDoS attack, and in extreme cases, our security policy may suspend your account.

An error response looks like this:

HTTP/2 400
Content-Type: application/problem+json

{
  "error": {
      "status": 400,
      "type": "https://dev.qweather.com/docs/resource/error-code/#invalid-parameters",
      "title": "Invalid Parameters",
      "detail": "Invalid parameters, please check your request.",
      "invalidParams": [
          "lang"
      ]
  }
}

INVALID PARAMETER#

HTTP response status code: 400

Invalid parameters, generally means that the incorrect parameter values were passed in, refer to error.invalidParams in the response for the specific invalid parameters.

MISSING PARAMETER#

HTTP response status code: 400

Missing parameters, error will be reported when some mandatory parameters are not passed, refer to error.invalidParams in the response for specific missing parameters.

NO SUCH LOCATION#

HTTP response status code: 400

The location queried was not found or unsupported. For example, a query for a city that does not exist or an incorrect Location ID, in which case you should check and try another location.

DATA NOT AVAILABLE#

HTTP response status code: 400

Data is temporarily unavailable. You will receive this error code when you query data that is not supported, for example, to query air quality for a location that is not yet supported, please try another location for your query.

UNAUTHORIZED#

HTTP response status code: 401

Authentication failed, you need to check your KEY or Token, we will not response to the specific cause of the error for security reasons.