Authentication And Access
To gain Access and be Authenticated by the Empower Time Track API, follow the following steps:
- Get a User Name and Password from Empower - this will be provided on request and will be in the form of apiCompanyNamexxxx (where company name is your Company Name and xxxx is a string).
For the security of your data, Empower Time Track API will verify that Clients or third party developers or systems are permitted to initiate a transaction before they make one. Empower will then authenticate each request. If the request cannot be authenticated, an appropriate message is returned.
- In the SOAP request header, your application or SOAP client must set the Username and Password elements to pass an API username/password combination.
The following example shows part of the AuthenticationCredential elements.
<soapenv:Header>
<web:AuthenticationCredential>
<web:UserName>apiCompanyNameAbcd </web:UserName>
<web:Password>apiPassword</web:Password>
</web:AuthenticationCredential>
</soapenv:Header>These elements are required for all SOAP requests.
- The API Connection/Authentication can be tested by a simple call to the function
PingWithAuthenticated(message As String) As String
You will get the message string back if the ping test is successful.
For an example see Example Code.