Output Endpoint with ServiceConfiguration (API/Web Service Call)
Please refer to the following post for more details: eFORMz API Management (Developer Resources)
There are two primary endpoints available to eFORMz customers. These are the ‘director’ and ‘output’ endpoints. For more on the ‘director’ endpoint, consult the following post: Director Endpoint with ServiceConfiguration (API/Web Service Call)
An “endpoint” is one end of a communication channel. When an API interacts with another system, the touchpoints of this communication are considered endpoints. For APIs, an endpoint can include a URL of a server or service. The place that APIs send requests and where the resource lives is called an endpoint.
The ‘director’ endpoint returns success or failure only. It processes data in the background. The ‘output’ endpoint processes data during the call and returns the results as part of the web service call. Both of these endpoints can take parameters either through the URL or in the data.
While the portion of the URL with authentication is encrypted for transmission, many people have policies restricting this practice. Passing the parameters in the data, including authentication, is possible using either XML or JSON. The order or sequence of elements in either format is not relevant to the processing.
<?xml version="1.0" encoding="utf-8"?> <ServiceConfiguration ServiceType="output" project="projects/OutputGuideServer/MapPackSlipData0.efz" format=".xml"> <InputData format="XML"> <Root> <abc>test</abc> </Root> </InputData> </ServiceConfiguration>
The root node must be named
ServiceConfiguration and the parameters are specified as attributes of that node. The
output parameter directs the eFORMz web service to return the output of an eFORMz project specified by the
project parameter. The calling application can pass in input data for the project in a variety of ways. The
InputData node with the attribute
format specifies the format of the embedded data. The data passed to the project is the
Root node and all of its descendant nodes (
abc in this example).
For more details on the eFORMz API, consult the following posts:
eFORMz API .NET Web Service Call
eFORMz API URL Parameters
Web Service POST call to “Wake Up” a “Sleeping” Queue: Part 1
Web Service POST call to “Wake Up” a “Sleeping” Queue: Part 2
Web Service POST call to “Wake Up” a “Sleeping” Queue: Part 3
Web Service POST Call Output Advantages
Web Service POST Call Output