The Noonlight API uses conventional HTTP status codes to indicate success or failure. Responses with a status code starting with 4xx or 5xx can be considered as failed. The API returns errors in JSON format in following structure:
{
"code": 400,
"message": "Bad Request",
"details": "A required field is missing"
}
Developer-friendly API
Noonlight attempts to provide a developer-friendly API, hence sometimes you can find a hint on how to fix an error right in its details (like in the example above).
| Attributes | Description |
|---|---|
code | The HTTP status code of error returned. Can be: 2xx, 4xx or 5xx |
key | For API object errors, a short string from amongst those listed below describing the kind of error that occurred |
message | A human-readable message providing short description about the error |
details | A human-readable message providing more details about the error |
| Key | Description |
|---|---|
resource_not_found | Entity with provided id does not exist |
invalid_payload | A request body is invalid and cannot be processed |
alarm_canceled | The alarm has already been canceled and can no longer be modified |