Webservices / APIs
The GetAuthToken webservice is used to generate an authentication token which you can use to authenticate all of the other Contegro webservice calls.
Authentication tokens have an expiry date (the length of time before a token will expire can change from site to site).
Normally, authentication tokens will only work from the IP address which the GetAuthToken request was made from (Contegro supports having multiple tokens associated with the same IP address).
The exception to this is authentication tokens which are generated from a call to the LogInUser webservice. These authentication tokens have a much longer expiry date and are not restricted to an IP address
If you are developing on a system which may change its IP address regularly (i.e.: a tablet or phone), you should keep track of when the IP address changes and request a new authentication token when that happens.
Data to be passed to the webservice
Data which is returned
Example XML for a GetAuthToken request
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
Example XML which is returned
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">