Summary

Hopewiser's SOAP Atlas API allows developers to add address lookup functionality to their web applications without the need for heavyweight coding.

If you're a developer looking for a simple address verification solution without the need for manual integration and storage of large data files then look no further: Hopewiser's SOAP Atlas API is the system for you.

By using the SOAP Atlas API developers can concentrate on the look and feel of their application; the functionality is provided by simple calls to Hopewiser's SOAP server.

If you are interested in Hopewiser's SOAP Atlas API please fill in our online enquiry form and a member of our team will contact you.

Developers

For clients employing .NET, we have soapatlas-dotnet.wsdl which is specifically targeted towards users choosing to deploy utilising .NET.

Most other users will want to use soapatlas-unbounded.wsdl which is fully compliant with Basic Profile 1.0. and so the recommended WSDL.

We also have soapatlas-soaparray.wsdl which uses SOAP array encoding for those client systems which cannot work with soapatlas-unbounded.wsdl.

Users who cannot import a WSDL file will need to use the sample XML responses and requests provided in the documentation for each call to interact with the SOAP service. The documentaion describes soapatlas-unbounded.wsdl which has the cleanest XML.

Login	Login to use the service
Modules	Retrieve information on available modules
Version	Retrieve version information
Status	Retrieve click count and expiry information
AH21	Postcode Lookup
List API	Partial Address Lookup
Logout	End address lookup session

If an error occurs during the invocation of a SOAP call, the Hopewiser SOAP server throws an exception and returns a SOAP fault element. This fault element contains details such that the type of the error may be determined. Look here for more information on the status codes returned.

Administrators

You may need to contact your administrators to ensure your own firewalls and proxies will allow through any requests.

We use ports 8001 to 8003 and our servers run in the IP address range 217.33.118.162-217.33.118.182 inclusive.

The URLs for the services are seen as:

http://soap1.hopewiser.com:8001/SOAPAtlas for soapatlas-soaparray.wsdl

http://soap1.hopewiser.com:8002/SOAPAtlas for soapatlas-unbounded.wsdl

http://soap1.hopewiser.com:8003/SOAPAtlas for soapatlas-dotnet.wsdl

We also have a number of Soap examples available for download