Skip to main content

Error Handling

Sample Error Responses

Written by Lenka Haringerová

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 Location header contains the URL of the newly created record, and the response body also includes its identifier.

304 Not Modified

The record has not been modified (used in combination with the If-Modified-Since header).

400 Bad Request

Bad request. This usually occurs during a failed PUT operation (e.g., 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 REST API for writing enabled. Read operations return 404 instead.

403 Forbidden

The user is not authorized to perform this operation. This error is also displayed if the operation is not permitted by the license.

404 Not Found

Record not found. This may refer to a record type (evidence) or a specific record (for example, because it was deleted).

405 Method Not Allowed

An unsupported method was used. For example, using the POST method where the data can only be read using GET.

406 Not Acceptable

The target format is not supported for the given 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 repeat the request.

500 Internal Server Error

An internal server error occurred while processing the request. Under normal circumstances, this should not happen and always indicates a bug in ABRA Flexi's code. Please let us know.

503 Maintenance

The server is undergoing maintenance. Please wait. If the situation 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.

⚠️ For codes 409 and 503, do not repeat the request immediately — wait until the running operation or maintenance has finished.


Sample 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>
Did this answer your question?