GetAuthentication Token

Contents

DRTrack APIs are built using Microsoft Windows Communication Foundation (WCF) framework that is SOAP based and implements WS-Security standards.

The service includes a full of set of APIs for data regarding orders, accounts, routes, and more. You can view the full WSDL here.

A unique URL is provided for each customer to access the service.

Testing the Service #

To test the DRTrack service, you will need to create a client and use it to call the service.

class Test
{
    static void Main()
    {
        DRTrackWebServiceClient client = new DRTrackWebServiceClient();
        // Use the 'client' variable to call operations on the service.
        // Always close the client.
        client.Close();
    }

Authentication #

Each API call must include an authentication token.

The GetAuthenticationToken API returns a token that is valid for 24 hours and can be used for all requests within that timeframe.

GetAuthenticationToken Request Parameters #

Name Description Type
username The username for the account.
string
password The password for the account.
string
applicationName The name of the Trimble MAPS application. (e.g. DRTrack)
string

Note: Please contact if you are a current DRTrack customer and you don’t know these required parameters.

Sample GetAuthenticationToken Method #

public string token { get; set; }
public Authentication GetAuthenticationObj()
        {
            AuthenticationResponseEnvelope response = wc.GetAuthenticationToken("username", "password", "applicationName");
            if (response != null && response.authenticationField != null)
            {
                MyToken = response.authenticationField.authenticationTokenField;
                if (response.responseStatusField != null && response.responseStatusField.errorField != null)
                {
                    var error = response.responseStatusField.errorField.FirstOrDefault();
                    if (error != null)
                    {
                        MessageBox.Show(error.codeField + error.messageField);
                    }
                }
            }
            return new Authentication
            {
                authenticationTokenField = MyToken
            };
        }

Sample XML Request #

<?xml version="1.0" encoding="utf-8"?>
<GetAuthenticationToken xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance>
  <username></username>
  <password></password>
  <applicationName><applicationName>
</GetAuthenticationToken>

Sample XML Response #

<?xml version="1.0" encoding="utf-8"?>
<AuthenticationResponseEnvelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ExtensionData />
  <authenticationField>
    <ExtensionData />
    <authenticationTokenField>DEV-Test-20170310040431-RI86TW</authenticationTokenField>
  </authenticationField>
</AuthenticationResponseEnvelope>
Last updated April 14, 2021.