Generic Response Message
All the REST services use a common XML Response message to deliver the results or statuses from a REST-call. Response message is sent both on success and error conditions: HTTP error messages are only sent if something is wrong in the HTTP protocol level. All application errors are reported via Response XML. The response comes always with HTTP response code '200 OK' and the client should investigate the actual code from <Status> and <StatusCode> elements for the real status of requested operation.
The format of the response (delivered in the BODY) is:
Status (repeats ONCE)
The overall status of the response. The contents are either 'OK' or 'ERR'.
StatusCode (repeats ONCE)
Four character alphanumeric representation of the status. The first character defines the system in Apix platform generating the message and the next is an internal function id, the last two characters are the actual error code.
?One character function code
(only in internal documentation)
ERROR Data contents invalid
ERROR No available saldo
ERROR No signed contract for requested operation
ERROR Permission denied
ERROR No data available
WARNING Saldo negative (only on receiving)
ERROR Saldo is too low for receiving. All incoming messages are rejected (only on receiving)
ERROR request misformed
ERROR Internal error
Note: It is recommended to show user also the StatusCode in error situations.
FreeText (Repeats 1..n)
This is a freetext response intended for displaying to the user. The text is sent always in English, but additional elements in different languages maybe provided by the service.
Value (Repeats 0..n)
This element contains additional information about the request intended for the client to refine.
Defines the role and meaning of the element value.