How can I test the APIs?
The QMWISe web service APIs are built using technology standards for web service development. QMWISe uses the Simple Objects Access Protocol standard, or SOAP as it is commonly known. The QMWISe implementation uses a Web Services Description Language (WSDL) to describe how the web services are formed and how to access them.
This means you can use a web service testing application that is compatible with SOAP and WSDL. This application can be used to:
- view the available QMWISe web services,
- send data to the server,
- and retrieve data from the server.
There are various (and free) web service testing applications available on the internet. Questionmark recommends soapUI.
Web service testing applications, such as soapUI, work by interrogating the QMWISe WSDL. The WSDL can be found, by default, in the following location:
OnDemand
https://ondemand.questionmark.com/qmwise/<customer ID>/qmwise.asmx?wsdl
or
https://ondemand.questionmark.eu/qmwise/<customer ID>/qmwise.asmx?wsdl
(European OnDemand customers)
...where <customer ID>
is the customer ID of your OnDemand account.
OnPremise
https://<OnPremise server>/qmwise/<tenant ID>/qmwise.asmx?wsdl
...where <OnPremise server>
is the valid domain name of your OnPremise server and <tenant ID>
is the tenant name.
Perception
http://<Perception server>/qmwise5/qmwise.asmx?wsdl
...where <Perception server>
is the valid domain name of your Perception server.
Once your web service testing application has interrogated the WSDL it will know what web service methods are available and what the parameters are for each. Each QMWISe web service is made of a number of properties Questionmark interprets depending on the web service used. The results of the interpretation are then passed back to the application that sent the request. When an application interprets a web service it may involve just retrieving some information or may include a process where certain actions are carried out by the application.