SmartSense API: Error Handling
Error responses can be returned for a variety of reasons such as the API being called incorrectly, using incorrect parameters, a permission or authentication issue, or the resource being deleted. We only list error codes that the API would likely send.
Error Codes
Error codes are numerical HTTP status codes that provide a brief message to end users describing the reported problem. These errors can affect performance operations and will need to be resolved for the API to function as intended. Additionally, we return a human-readable text response.
The following error codes are returned by this API:
Error Code | Meaning |
400 | Bad Request -- The request contains an invalid payload. |
401 | Unauthorized -- The API key provided is not allowed to perform the operation. |
403 | Forbidden -- The API key provided is not allowed to perform the operation. |
404 | Not Found -- The specified resource could not be found. |
405 | Method Not Allowed -- The specified request is not allowed. |
406 | Not Acceptable -- The format of the request is not acceptable. Supported format is json. |
409 | Conflict - The request could not be completed due to a conflict with the current state of the target resource. |
410 | Gone -- The resource is no longer available. |
422 | Unprocessed Entity -- Logic conflicts in provided parameters. |
429 | Too Many Requests -- Too many requests have been made for this interval. |
500 | Internal Server Error -- The server had an unexpected error. |
503 | Service Unavailable -- The server is offline for maintenance. Please try again later. |
Rate Limiting
Rate limiting is a method used to restrict network traffic so that resources are not monopolized and are available for all end users.