Errors
The API and WebSocket connections handle errors in the following ways:
-
Client-Side Errors (HTTP 400):
These errors occur due to invalid input provided by the client, such as malformed requests, unsupported message types, validation problems, rate limiting and others. -
Authentication and Authorization errors (HTTP 401 and HTTP 403)
-
Server-Side Errors (HTTP 500):
These errors indicate an internal issue within the system that prevents the request from being processed.
Error notifications are sent only to the client that caused the error. Other connected clients remain unaffected.
Each error message provides details to help diagnose and resolve the issue.
Errors sent via WebSocket connection are wrapped in standard message envelope in payload property, with optional correlationId property included in error object.
Example - wrong query
GET https://isot.okte.sk/api/v1/idm/orders?offset=0&limit=10{
"code": "RangeFilterRequired",
"message": "Parameters 'DeliveryFrom' (with/without 'DeliveryTo') or 'CreatedFrom' (with/without 'CreatedTo') or 'UpdatedFrom' (with/without 'UpdatedTo') are required."
}