Contact Us 1-800-596-4880
  1. Homepage
  2. APIkit (4.x)
  3. APIkit for OData V4

  4. Error Handling Reference

APIkit for OData v4 Error Handling Reference

APIkit for OData v4 maps routing, parsing, serialization, and expansion failures to typed APIKIT-ODATA errors you handle in Mule. Use the error catalog and scaffolded handler in this reference to interpret failures and return consistent OData error payloads.

Error Types

APIkit for OData v4 defines error types for common OData processing failures:

Error Type Description

APIKIT-ODATA:NOT_IMPLEMENTED

Requested service, feature, or operation not implemented

APIKIT-ODATA:MALFORMED_URI

Invalid request URI

APIKIT-ODATA:MALFORMED_SEARCH

Invalid request $search expression in URI

APIKIT-ODATA:SERIALIZATION

Generic error for serialization issues

APIKIT-ODATA:DESERIALIZATION

Generic error for deserialization issues

APIKIT-ODATA:TRANSFORMATION

Generic error for issues related to URI to SQL transformations

APIKIT-ODATA:INTERNAL_SERVER_ERROR

Generic error for internal server issues

APIKIT-ODATA:NOT_FOUND

Generic error for not found

APIKIT-ODATA:EXPANSION

Generic error for issues during expansion

Error Handling

APIkit for OData v4 scaffolder generates an error handler with a single On Error Propagate catch that serves as a generalized error formatter.

...
    <error-handler name="Error_Handler">
      <on-error-propagate name="On_Error_Propagate" enableNotifications="true" logException="true" type="ANY">
        <ee:transform>
          <ee:message>
            <ee:set-payload><![CDATA[%dw 2.0
output application/json
---
{
	error: {
		code: error.errorMessage.payload.code default "UNKNOWN",
		message: error.errorMessage.payload.message default error.description,
		target: error.errorMessage.payload.target,
		details: error.errorMessage.payload.details default [{code: "UNKNOWN", message: error.detailedDescription, target: null}],
		innererror: error.errorMessage.payload.innerError default error.childErrors
	}
}]]></ee:set-payload>
          </ee:message>
          <ee:variables>
            <ee:set-variable variableName="statusCode"><![CDATA[error.errorMessage.payload.statusCode default 500]]></ee:set-variable>
          </ee:variables>
        </ee:transform>
      </on-error-propagate>
    </error-handler>
...

See Also