Understand Climate On Demand HTTP status codes
The Climate On Demand API indicates the success or failure of an API request with a status code. These status codes are displayed in the message body of the HTTP response.
HTTP response status codes enable you to verify normal behavior and provide context for understanding exceptions.
Climate on Demand uses standard HTTP response codes to indicate the success or failure of an API request. The table summarizes the significance of these response codes and links to documentation in RFC 9110.
| Code | Definition |
|---|---|
| 200 OK | An OK status indicates that the request was successful. In general, the Climate on Demand API returns a 200 OK response for all successful requests. |
| 400 Bad Request | The Bad Request status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).`Indicates a validation error or that the request parameters were incorrect. |
| 401 Unauthorized | The Unauthorized status indicates that the credentials are missing or invalid, e.g no valid API key was provided. |
| 403 Forbidden | The Forbidden status indicates that access to the resource is denied or unauthorized. |
| 404 Not Found | The Not Found status indicates that the resource was not found. |
| 405 Method Not Allowed | The Method Not Allowed status indicates that the requested action is not allowed. |
| 500 Internal Server Error | The Internal Server Error status code indicates that the server could not fulfill the request due to an unexpected condition. ` |