The user is informed about errors using an HTTP status code.
HTTP code | Meaning |
200 OK | The operation was completed successfully. |
201 Created | The record was created successfully. The |
304 Not Modified | The record has not been modified (in combination with the |
400 Bad Request | Bad request. This usually occurs during a failed PUT operation (e.g., you are referencing an object that does not exist). |
401 Unauthorized | The user must log in to perform this operation. |
402 Payment Required | The target system does not have the write REST API enabled. Read operations return 404. |
403 Forbidden | The user does not have permission to perform this operation. This error also appears if the operation is not allowed by the license. |
404 Not Found | Record not found. This may refer to a record type or a specific record (e.g., because it was deleted). |
405 Method Not Allowed | An unsupported method was used. For example, using the POST method where only reading data via GET is allowed. |
406 Not Acceptable | The target format is not supported for this particular resource (e.g., exporting an address book as ISDOC). |
409 Conflict | The same or a conflicting operation is already running on the server (for example, a stock recalculation or an update of issue requirements). Wait for the running process to finish and then repeat the request. |
500 Internal Server Error | An internal server error occurred while processing the request. This should not normally happen and always indicates a bug in the ABRA Flexi code. Please let us know. |
503 Maintenance | The server is undergoing maintenance. Please wait. If the condition persists, please contact us. |
Unless it is a 500 error, the response usually also includes a machine-readable description (XML, JSON). The format is the same as for validation messages.
Example of an error response:
<?xml version="1.0"?>
<winstrom version="1.0">
<success>false</success>
<result>
<id>105</id>
<error>Je očekáváno číselné ID, ale 'null' není číslo</error>
</result>
</winstrom>