Skip to main content

Summary of Web Service URLs

This topic summarizes the URLs related to an InterSystems IRIS® data platform web service.

Web Service URLs

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

end point for the web service
https://<baseURL>/csp/namespace/web_serv.cls

Where:

  • <baseURL> is the base URL for your instance.

  • /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:

https://devsys/csp/mysamples/MyApp.StockService.cls
WSDL
https://<baseURL>/csp/app/web_serv.cls&WSDL

For example:

https://devsys/csp/mysamples/MyApp.StockService.cls?WSDL

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:

https://devsys/csp/mysamples/MyApp.StockService.cls?WSDL&IRISUsername=
_SYSTEM&IRISPassword=SYS

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:

https://devsys/csp/mysamples/MyApp.StockService.cls?WSDL&IRISUsername=
_SYSTEM&IRISPassword=SYS&IRISNoRedirect=1

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 there is a legacy application that uses CSP/ZEN to serve the WSDL and its Prevent login CSRF attack setting is enabled, then temporarily disable the setting if you determine that it is safe to do so. For more information, see content on settings in this type of legacy applicationOpens in a new tab.

FeedbackOpens in a new tab