IRESS Web Services

Programmer's Guide

• Using our SOAP methods

  The web services can be accessed via the Internet using the Simple Object Access Protocol (SOAP). Your software (the client) needs to be able produce a valid SOAP request.

  Our software (the server), has currently been configure to 'listen' using HTTP protocol.

  The client should use the HTTP POST method to send the SOAP request to our server.

  Your client needs only to produce a valid SOAP request, use HTTP POST to send the request, and read the SOAP response.

  The key point we would like to make is, your client software can be developed on any platform, using any language.

  For example, on a UNIX platform, you could of course use C/C++, as well as Java or even Perl to do this.

  We are using the Microsoft Windows platform, using the Microsoft SOAP Toolkit 2.0 to build our test client software, and most of our samples use this.

  HTTP

  If you are on a non-Microsoft platform, and are not using any SOAP libraries, you can still perform methods calls using HTTP.

  The HTTP POST to call the IRESSXMLData.Logon CreateSessionKey method should look like the following:

  POST /xmldata/200304/Logon.asp HTTP/1.1
  Content-Type: text/xml; charset="UTF-8"
  Host: webservices.iress.com.au
  SOAPAction: "http://webservices.iress.com.au/xmldata/200304/Logon/action/Logon.CreateSessionKey"
  Content-Length: 606
  Connection: Keep-Alive
  Cache-Control: no-cache 
  Pragma: no-cache 
  
  <?xml version="1.0" encoding="UTF-8" standalone="no" ?><SOAP-ENV:Envelope xmlns:SOAPSDK1="http://www.w3.org/2001/XMLSchema"xmlns:SOAPSDK2="http://www.w3.org/2001/XMLSchema-instance"xmlns:SOAPSDK3="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAPSDK4:CreateSessionKey xmlns:SOAPSDK4="http://webservices.iress.com.au/xmldata/200304/Logon/message/"><UserName>username@company</UserName><Password>password</Password></SOAPSDK4:CreateSessionKey></SOAP-ENV:Body></SOAP-ENV:Envelope>

  SOAP Toolkit 3.0 - Visual Basic Script Example

  Below is a simple example of calling the web services using VBScript and the SOAP toolkit.

  Const WS_USERNAME = "user@company"
  Const WS_PASSWORD = "password"
  
  Const BASE = "http://webservices.iress.com.au/xmldata/200304/"
  
  Call Main
  
  Sub Main
  	Dim logon, PriceXMLReq, sessionKey, strXML
  
  	call CreateSOAPClient(logon, BASE & "wsdl/logon.wsdl", BASE & "logon.asp")
  	sessionKey = logon.CreateSessionKey(WS_USERNAME, WS_PASSWORD)
  
  	call CreateSOAPClient(PriceXMLReq, BASE & "wsdl/PriceXMLReq.wsdl", BASE & "PriceXMLReq.asp")
  	strXML = PriceXMLReq.GetPriceQuote(sessionKey, "BHP", "ASX", 0)
  
  End Sub
  
  Function CreateSOAPClient(objSOAP, strWSDL, strEndPointURL)
  	Set objSOAP = CreateObject("MSSOAP.SoapClient30")
  	objSOAP.MSSoapInit(strWSDL)
  	objSOAP.ConnectorProperty("EndPointURL") = strEndPointURL
  End Function
  	

  Microsoft Internet Information Server (IIS)

  If you are using IIS 4.0 (Windows NT) or 5.0 (Windows 2000), the easiest way to perform SOAP requests in your ASP it to use Microsoft SOAP Toolkit 2.0.

  We have prepared some files which can easily be included in your ASP project.

  IRESSWebServices-Sample1 is a complete sample ASP application, demonstrating most of the web services, and these include files.

  Please download and install it, and look at the source code for further ideas. (The download file requires Microsoft Windows Installer to be already installed). The Readme file explain the steps of the installation as well as some sample input data for the sample.