Table of Contents |
---|
Message request header
All header content is under traceHeader element that contains traceIdentifier element with tracing information of incoming message.
TraceIndentifier parameters
Parameter | Type | Description | Mandatory |
---|---|---|---|
applicationID | string | Identification of source application. | Y |
timestamp | dateTime | Timestamp of sent request. | Y |
correlationID | string | Used to track calls from the service consumer to the API. | Y |
processID | string | Used to track calls connected to one process (e.g. one process is "creating new customer" and it means calling creating customer, then activating him etc.) This parameter is free text, unique value (e.g. UUID), generated by the caller. | N |
SOAP example:
Code Block | ||
---|---|---|
| ||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:com="http://openhubframework.org/ws/Common-v1" xmlns:hel="http://openhubframework.org/ws/HelloService-v1"> <soapenv:Header> <com:traceHeader> <com:traceIdentifier> <com:applicationID>APPL001</com:applicationID> <com:timestamp>2013-05-21T10:33:58.147+02:00</com:timestamp> <com:correlationID>${=java.util.UUID.randomUUID()}</com:correlationID> <!--Optional:--> <com:processID>process001</com:processID> </com:traceIdentifier> </com:traceHeader> </soapenv:Header> <soapenv:Body> <hel:asyncHelloRequest> <hel:name>CleverBusname>OpenHub team</hel:name> </hel:asyncHelloRequest> </soapenv:Body> </soapenv:Envelope> |
...
Info |
---|
It's good practice to use specific response for one request and not one common response for all requests: asyncHelloResponse -> asyncHelloRequest |
If error occurred during incoming message processing (ThrottlingExceededException and StoppingException at this moment) then fault response is generated (identical for synchronnous message). Fault response contains error description and error code for clear indentification.
...