VLT-Website-Heading

Testing connectivity with pymetrics Web Services APIs using SOAP UI software

Nov 17, 2019 6:54:19 PM / by Vu Long Tran

This guide will explain how you can use SOAP UI Open Source software to run API calls to pymetrics Web Services APIs.

I will run you through the steps of how to set up your environment so you can start testing and engaging with the pymetrics Web Services APIs.

How to test the pymetrics Web Services using SOAP UI

Step 0 - Install Soap UI Open Source

If you haven't already done so, please download and install the free SoapUI Open Source software on your computer via soapui.org/downloads/soapui.html. For basic details demo on how to test it on a public free API data source, you can review this post here.

Step 1 - Add pymetrics Web Services to SOAP UI

Add a "New SOAP Project" to your SOAP UI software by clicking on File> New SOAP Project and add in the following details:

  • Project name: pymetrics Web Services (or your name of choice)
  • Initial WSDL link: https://www.pymetrics.com/docs/integrations/webservice/v2
  • Create Requests: Tick (optional but it's good for auto generating some sample body data that you often need to send with requests so you start getting familiar with it).
Create a "New SOAP Project" where you add in the pymetrics.com WSDL link
Add in the pymetrics.com WSDL link

Step 2 - Test that your new pymetrics SOAP project is working

You will want to test that you have added the new SOAP project and it is configured to the pymetrics Web Services endpoint correctly. The best way to test is using the Echo API.

The goal of the Echo API is to just respond back to let you know that it has received your API call. No authentication is needed so you can use this API call to just confirm the connectivity and connection.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pym="pym.intg.ws.2.0.0">
<soapenv:Header/>
<soapenv:Body>
<pym:echo>
<pym:echo>Test Echo</pym:echo>
</pym:echo>
</soapenv:Body>
</soapenv:Envelope>

Step 3 - Echo API should repeat what you have sent

Echo API should repeat (echo) what you have sent. As it's goal is to confirm that it has received your API request and sends back the same message in response.

If you have received the same message, then you're successful in configuring your SOAP UI to interface with the pymetrics Web Services endpoint.

Here are some examples of how the Echo API should function:


Using the Echo API call to send the words "Test Echo"
Using the Echo API call to send the words "Sending a different message to Echo"

Step 4 - Success your SOAP UI is configured!

You are now configured to start using SOAP UI and engaging with the pymetrics Web Services endpoint.

(Optional) Nice to have configuration for SOAP UI

You can consider seeing up your SOAP UI environment so that it shows some helpful functionality.

I like to turn on the Debug, Header tab, and Request Properties windows, as this gives me more information about the API calls and endpoints that am working with.

Example configuration with "Header" window open
Example configuration with "Header" window open
Example configuration with "Debug" window open
Example configuration with "Debug" window open

Enjoy using SOAP UI to test your endpoints!

Topics: tech, web services, apis

Vu Long Tran

Written by Vu Long Tran

Solutions Engineer APAC. ex-@Forrester consultant. Writing on #cloud #howto guides and #tech tinkering!