Connect to the SOAP API

The SOAP API exposes web services that applications use to interact with Smile.

This task explains how to connect each application to the SOAP API.

  1. Review the library you will use to write the API application, or review the functionality of the Smile Java SOAP client.
    The Java client provides an easy way to call methods in the API.
  2. Download and review the WSDL and schema for each API endpoint that you want to use.
    Reviewing the WSDL and schema lets you become familiar with the methods and element definitions in the API. The WSDL is located at the following URL, where endpoint is the name of the Smile endpoint, for example, account or subscription.
    WSDL location: http://smile.example.com:port/stage/smile/ws/v2/endpoint?wsdl
    Schema location: Listed in each WSDL.
    Some SOAP libraries use the WSDL to generate stubs, which can also help you write your application.
  3. Write a test application using the echo() method.
    The API uses HTTP basic access authentication. Ensure you supply the authentication credentials in the correct basic access format for your library.
  4. Use the test application to verify the connection to the API.
    You can now connect to the SOAP API.
To use the full range of Smile API functionality, you should now connect to the message bus.