Create an Endpoint Service Definition

An Endpoint (reference) contains the webservice definition, technically. For A SOAP webservice this is the WSDL.

Short Overview of the task

  • Switch to the endpoint view
  • Create an endpoint and enter the endpoint-wsdl URL
  • Download the WSDL definition
  • View the endpoint definition
  • Next steps

Tasks

If you want to test a SOAP webservice, you need to import the WSDL. This has several reasons

  • APIJockey TEST will read all types, operations, port types, messages and bindings provides these information in a searchable view.
  • The creation of SOAP Teststep will require you to enter a specific operation. This is the base for the schema validation of your request.

Create an Endpoint (reference)

Start APIJockey TEST in Launchpad APIJockey TEST app icon.
You will see the sidebar on the left. On the top just before the colored window handles, you will see the tab bar. When you start APIJockey TEST, the tab Test defintion is selected. tabview on sidebar, testdefinition selected Switch to endpoint definition as shown here: tabview on sidebar, endpoints selected

This view will be empty when you haven't yet imported a WSDL definition.
We will use an WSDL created by the w3c.org consortium which you can find here and load in your browser. http://schemas.xmlsoap.org/ws/2004/09/enumeration/enumeration.wsdl

Let's drag the sidebar to the right, this will show the tabs Endpoint, Test Definition and Test Execution

APIJockey with enlarged sidebar

Click the Button New Endpoint Reference Button APIJockey Sidebar new endpoint

A new modal dialog comes up. Enter the following URL: http://schemas.xmlsoap.org/ws/2004/09/enumeration/enumeration.wsdl.
In general the WSDL is passed as an URL-Parameter, but we take the url as provided.

Add the following data:

  1. Enter the URL
  2. Tab to next textfield to see a default endpoint name
  3. Make sure the toggle start download after confirmation is enabled.
  4. Confirm the dialog with OK.
Button APIJockey Sidebar new endpoint

The Application will download the WSDL data and display a new entry unter Endpoints with the endpoint name you entered. The first part is done.

When you select an endpoint and click the tab types you will see the list of XSD files that imported to or included in the WSDL. You can select each of them, read them and search within them

Endpoint dialog dialog

When you select an endpoint and click the tab Textview you will see original the WSDL. You can search here as well.

Once you have an Endpoint (reference), you will be able to create a SOAP Teststep.
See Testdefinition and Create a Testdefinition
See more about Endpoint Service Definition