The API uses standard HTTP return codes. Those codes are three number codes that can be groupes into 4 categories:
- 1xx : information
- 2xx : success
- 3xx : redirection
- 4xx : client error
- 5xx : server error
During operation, you will generally encounter 2xx, 4xx and 5xx codes.
Codes in the 400 and 500 range are errors. When those occurs, you will often find additional information in the response body about the error that occurred.
4xx - client errors
These errors indicates that there is something wrong in the request that was made. You should generally be able to solve this error by changing the request you are doing.
You can find additional information about these errors here.
5xx - server errors
These errors indicates that something wrong occurred on the gateway. As the server (the gateway) is a dynamic environment, these errors can happen for many reasons.
You may first try to execute the request again to ensure it's due to the request or the state of the gateway.
You may sometimes get a 5xx error code due to a bad argument that has not been checked by the Manager before being used. This means some 5xx errors can be solved ba changing the request.
Other 5xx errors are related to the state of the gateway, its current configuration. You will generally find additional details about the error in the response body.
Do not hesitate to report those errors to suppor@iot.wifx.net so that we can improve control of the request and provide the most precise error code and message.