Skip to main content
Previous sectionNext section

Summary of Web Service URLs

This topic summarizes the URLs related to an InterSystems web service.

Web Service URLs

The URLs related to an InterSystems IRIS web service are as follows:

end point for the web service
base/csp/namespace/web_serv.cls
Copy code to clipboard

Where:

  • base is the base URL for your web server (including port if necessary).

  • /csp/namespace is the name of the web application in which the web service resides.

  • web_serv is the class name of the web service.

For example:

http://localhost:52773/csp/samples/MyApp.StockService.cls
Copy code to clipboard
WSDL
base/csp/app/web_serv.cls&WSDL
Copy code to clipboard

For example:

http://localhost:52773/csp/samples/MyApp.StockService.cls?WSDL
Copy code to clipboard

Note that both of these URLs are part of the /csp/namespace web application.

Using a Password-Protected WSDL URL

You can use the WSDL URL of an existing InterSystems IRIS web service to create a web client in InterSystems IRIS or a third-party tool. However, if the parent web application for the web service requires password authentication, you must supply a valid username and password in the WSDL URL to access the WSDL. To do so, you append &IRISUsername=username&IRISPassword=password to the URL, for example:

http://localhost:52773/csp/samples/MyApp.StockService.cls?WSDL&IRISUsername=
_SYSTEM&IRISPassword=SYS
Copy code to clipboard

Additionally, if you use a third-party tool to create the web client and the tool uses URL redirection after logins, you must append &IRISNoRedirect=1. For example, after a login, .NET performs a URL redirect. Consequently, the WSDL URL format for a .NET web client is as follows:

http://localhost:52773/csp/samples/MyApp.StockService.cls?WSDL&IRISUsername=
_SYSTEM&IRISPassword=SYS&IRISNoRedirect=1
Copy code to clipboard

If you are unable to generate a web client from a password-protected WSDL URL after several attempts, consider the following alternatives:

  • Retrieve the WSDL from a browser by supplying a valid username and password, save the WSDL as a file, and use the file to generate the web client.

  • If the web service must provide continuous access to the WSDL, create a web application that is not password protected to serve the WSDL.

  • If the Prevent login CSRF attack setting is enabled for web application serving the WSDL, temporarily disable the setting if you determine that it is safe to do so. For more information, see “Editing an Application’s General Attributes” in the Security Administration Guide.