SOAP API Testing

SOAP (Simple Object Access Protocol) is an XML-based protocol for accessing web services. SOAP APIs communicate using standardized XML messages, defined by WSDL (Web Services Description Language) files that specify available operations and message formats.

Boomerang streamlines SOAP API testing by importing WSDL files to automatically discover available services, parsing WSDL definitions to understand service operations, and handling SOAP message structure and namespaces, generating properly formatted XML requests with default values.

WSDL Import Process

1. Navigate to the main Boomerang interface
2. Select "Import" from the top navigation bar
3. Select "WSDL" as the import type
4. Choose import source:
   • Enter WSDL URL in the provided field, or
   • Click "Choose File" to select a local WSDL file
5. Click "Import" to process the WSDL

After successful import, the service appears in the left navigation panel. Expand the service to view available operations, where each operation displays its corresponding method name.

Creating SOAP Requests

1. Locate desired operation in the service navigation
2. Double-click the operation name
3. The system generates a default request structure with XML schema-compliant body
4. Navigate to the Body tab
5. Modify the pre-generated XML:

SOAP Request

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/">
   <x:Body>
      <!-- Insert request parameters here -->
   </x:Body>
</x:Envelope>

Executing the Request

Before sending the request, verify the endpoint URL and validate the request body structure. Click the "Send" button to process the request. The response will appear in the response panel.

Example Implementation

Sample WSDL Import

URL: http://www.webservicex.net/ConvertTemperature.asmx?WSDL

Sample Request Configuration

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/"
            xmlns:web="http://www.webserviceX.NET/">
   <x:Body>
      <web:ConvertTemp>
         <web:Temperature>100</web:Temperature>
         <web:FromUnit>degreeFahrenheit</web:FromUnit>
         <web:ToUnit>degreeCelsius</web:ToUnit>
      </web:ConvertTemp>
   </x:Body>
</x:Envelope>

Troubleshooting

When encountering WSDL Not Found errors, verify URL accessibility and check network connectivity. For parse errors, ensure WSDL file is valid, check XML structure, and confirm schema references.

For request execution issues, verify the endpoint availability and check your network settings.

If you're still experiencing issues with specific WSDL files despite these checks, please contact our support team. We're actively improving our WSDL parsing engine, and your feedback helps us enhance compatibility. When reporting WSDL issues, please include the WSDL file or URL to help us resolve the problem in our next release.