Error Responses
When ever the request fails, a HTTP error status and an ERS response content is returned back to client in order to describe the problem. The following table describes possible errors:
Error Code | Description | HTTP STATUS |
---|---|---|
VERSION_EXCEPTION | Occurs when the resource version sent in the request content is not supported anymore by the server. | 415 |
MEDIA_TYPE_EXCEPTION | Occurs when the media type sent by the client in the ACCEPT or Content-Type headers is invalid. | 415 |
UNSUPPORTED_RESOURCE_EXCEPTION | Occurs when the resource as appear in the URI, does not supported by the server. | 400 |
UNSUPPORTED_METHOD_EXCEPTION | Occurs when the request method type is not supported for the specified URI. | 400 |
QUERY_VALIDATION_EXCEPTION | Occurs when the search filter or paging parameters are not valid. | 400 |
SCHEMA_VALIDATION_EXCEPTION | Occurs when the resource validation against its schema fails. | 400 |
APPLICATION_RESOURCE_VALIDATION_EXCEPTION | Occurs when the resource semantic validation does not meets the requirements | 400 |
INTERNAL_EXCEPTION | Any unexpected internal server error that occurs at runtime. | 500 |
CONVERSION_EXCEPTION | Occurs for some internal conversions and should be treated as INTERNAL_EXCEPTION | 500 |
CRUD_OPERATION_EXCEPTION | Occurs during the CRUD operation execution and should be treated as INTERNAL_EXCEPTION | 500 |
The following example demonstrates a response with media type error that happens when the client sent an unsupported mediatype in the ACCEPT header:

The following example demonstrates a response with a schema validation error that happens because a mandatory field - 'name' is missing
