Client applications use the SOAP protocol to communicate with DC Gateway. The body of SOAP request and response messages contain the name of a web service operation and, in addition, all input or output parameters. The body is enclosed in an envelope and both parts of each message are encoded using extensible markup language (XML). Requests and responses are exchanged by the client application and DC Gateway’s web services in the same way that a web browser communicates with a web server across the Internet – using the secure form of the Hypertext Transfer Protocol (HTTPS).
- DC Gateway SOAP APIs are based on open, web services standards, including the Simple Object Access Protocol (SOAP), Web Services Definition Language (WSDL), and the XML Schema Definition language (XSD).
- Submit a request to the endpoints of web services with the query string of ‘WSDL’ to generate files that define the operations, parameters and data structures supported by DC Gateway APIs.
- Inspect status code from HTTP header to verify that request message was successfully received by DC Gateway.
- Inspect Result (or ResultCode) from SOAP Message body to reveal outcome from DC Gateway Web Service operation that was invoked.