When consuming a REST API method, if the service returns an HTTP error status code (400 and above), OutSystems throws an exception. This allows you to handle the REST API error response by implementing your own logic.
To handle a REST API error, do the following:
Add an Exception Handler to the logic that uses the REST API method, and set the Exception property to
All Exceptionsso that the exception handler catches all exceptions.
Implement the logic in the exception handler flow to handle the error, like displaying a message to the end user.
Manipulating received error responses
In certain situations you might want to manipulate a REST error response at a lower level, before OutSystems throws an exception.
You can do this by using the OnAfterResponse callback or, in more advanced scenarios, the OnAfterResponseAdvanced callback. These actions run before OutSystems processes the REST response, and you can use them to manipulate the response headers, body, and status code.
For example, you might want to:
Throw specific User Exceptions based on the received error.
Change the status code of a REST error response to 200 (success) so that OutSystems doesn't raise an exception in a specific case.