nHTTP REST Support

The nHTTP listener for iWay Service Manager complies with the HTTP 1.1 specification. The listener implements all the available verbs used in REST-style communication, including the main verbs (GET, POST, PUT, and DELETE). The handling of the verbs can be configured during the nHTTP listener configuration and allows you to indicate if the verb should generate an event document, which will propagate to the process flow or if it should generate an error. The key here is that this ability to create an event document from the HTTP request allows an iSM channel to execute an underlying process flow from a URL request. As the URL request is being served by the nHTTP listener, the event document is generated, the process flow is executed, and the response document is returned via HTTP. This enables any process flow to run from any external application by issuing a URL reference to it. The REST style service support of addressing a resource with a supported set of verbs is available via the nHTTP listener implementation. For more information on a full array of nHTTP supported features, see the iWay Service Manager User’s Guide.

The following table lists the supported HTTP requests.

Request Type

Available Actions

GET

  • docroot - serve document from docroot.
  • event - generate an event document.
  • error - return HTTP error.

POST

flow - non-configurable, request propagated to flow

HEAD

  • docroot - serve document from docroot.
  • event - generate an event document.
  • error - return HTTP error.

PUT

  • event - generate an event document.
  • error - return HTTP error.

DELETE

  • event - generate an event document.
  • error - return HTTP error.

TRACE

Echoes request as per RFC.

OPTION

Returns available options as per RFC.