Automated Access API

This API allows you to integrate location data from your vehicles into your web site(s) and/or data collection infrastructures.

There are four API functions at this time.

  1. To return the last location of the vehicles associated with your account.
  2. Return all locations for a specific vehicle between two dates (maximum 500)
  3. Configure the starter disable functionality of one of your vehicles
  4. Configure the payment reminder functionality of one of your vehicles

The API is based upon an HTTP POST request followed by an XML response.


1. In order to access the last location of all vehicles for a specific user a login and password need to be posted to

https://www.sysdevx.com/api/v2/GetAllVehicles.php

For example:

<form method='post' 
    action='https://www.sysdevx.com/api/v2/GetAllVehicles.php'>
  <input type='text' name='login' value='your_login' />
  <input type='text' name='password' value='your_password' />
  <input type='submit'>
</form>

The response will be ordered by serial number in descending order and look like:

<response>
<status code="100" msg="Success"/>
<vehicle serial="2002348" date="1170813924" lat="49.2520500" 
  lng="-123.1108800" type="18" address="271 W 21st Ave, Vancouver, BC, V5Y" 
  speed="0" heading="0"/>
<vehicle serial="2001452" date="1157654983" lat="49.2521320" 
  lng="-123.1111760" type="17" address="" speed="0" heading="0"/>
<vehicle serial="2001450" date="1168890892" lat="32.7947333" 
  lng="-117.1367500" type="0" address="8999 Gowdy Ave, San Diego, CA, 92123" 
  speed="0" heading="-1"/>
</response>

Where the dates are all in unix time format (seconds from Jan 1st 1970), heading is in degrees, speed is in mph (miles per hour), and the type field corresponds to:

Type Meaning
1 Geofence entry alert
2 Geofence exit alert
3 Speed alert
17 Movement alert
3 StopTrack alert
20 Input2 alert

The code element of the response XML file contains a status code and a message. The possible status codes are:

Code Message
100 Success
101 Failed, could not connect to database.
102 Failed, could not login with supplied login/password
103 No vehicles for this account

Test it here using your own account login and password.

Login:
Password:

2. In order to get the locations for a specific vehicle you need to post login, password, vehicle serial number, start date, and end date to the following: (Please note that dates must be in Coordinated Universal Time and can be in yyyy-mm-dd hh:mm format or just yyyy-mm-dd. If hours are used then specify in 24 hour format)

https://www.sysdevx.com/api/v2/GetLocationsByDate.php

For example:

<form method='post' 
    action='https://www.sysdevx.com/api/v2/GetLocations.php'>
  <input type='text' name='login' value='your_login' />
  <input type='text' name='password' value='your_password' />
  <input type='text' name='serial' value='2002348' />
  <input type='text' name='start' value='2006-02-02' />
  <input type='text' name='end' value='2007-02-03' />
  <input type='submit'>
</form>

The response will be ordered by location date in descending order and look like:

<response>
<status code="100" msg="Success"/>
<location date="1170444494" lat="49.2492140" lng="-123.1155700" type="17" 
  address="" speed="20" heading="1"/>
<location date="1170444385" lat="49.2472000" lng="-123.1157400" type="17" 
  address="" speed="0" heading="0"/>
<location date="1170444324" lat="49.2452350" lng="-123.1155240" type="17" 
  address="" speed="8" heading="279"/>
<location date="1170444265" lat="49.2432170" lng="-123.1093140" type="17"
  address="" speed="24" heading="324"/>
<location date="1170440329" lat="49.2433850" lng="-123.1078200" type="18" 
  address="4581 Clancy Loranger Way, Vancouver, BC, V5Y" speed="0" 
  heading="0"/>
</response>

The code element of the response XML file contains a status code and a message. There is a maximum number of 100,000 locations returned. If you receive 100,000 locations then you should narrow the date range of your search. The possible status codes are:

Code Message
100 Success
101 Failed, could not connect to database.
102 Failed, could not login with supplied login/password
104 Failed, not able to find the vehicle in the database

Test it here using your own information:

Login:
Password:
Serial # (7 digits):
Start Date (yyyy-mm-dd):
End Date (yyyy-mm-dd):

3. In order to configure the starter disable functionality of one of your vehicles you must post login, password, vehicle serial number and the desired state of the starter disable to the following url, please note that enabling starter disable means the car will not start. Also, this API call may take up to 60 seconds to respond.

https://www.sysdevx.com/api/v2/SetStarterDisable.php

For example:

<form method='post' 
    action='https://www.sysdevx.com/api/v2/SetStarterDisable.php'>
  <input type='text' name='login' value='your_login' />
  <input type='text' name='password' value='your_password' />
  <input type='text' name='serial' value='2002348' />
  <input type='text' name='state' value='1' />
  <input type='submit'>
</form>

The response will be based upon the status of the vehicle and will look like:

<response>
<status code="100" msg="Success"/>
</response>

The code element of the response XML file contains a status code and a message. The possible status codes are:

Code Message
100 Success
101 Failed, could not connect to database.
102 Failed, could not login with supplied login/password
104 Failed, not able to find the vehicle in the database
105 Failed, not able to connect to vehicle through cellular network

Test it here using your own information (may take up to 60 seconds to respond):

Login:
Password:
Serial # (7 digits):
State (0 to disable, 1 to enable):

4. In order to configure the payment reminder functionality of one of your vehicles you must post login, password, vehicle serial number and the desired state of the payment feature to the following url, please note, this API call may take up to 60 seconds to respond.

https://www.sysdevx.com/api/v2/SetPayment.php

For example:

<form method='post' 
    action='https://www.sysdevx.com/api/v2/SetPayment.php'>
  <input type='text' name='login' value='your_login' />
  <input type='text' name='password' value='your_password' />
  <input type='text' name='serial' value='2002348' />
  <input type='text' name='state' value='1' />
  <input type='submit'>
</form>

The response will be based upon the status of the vehicle and will look like:

<response>
<status code="100" msg="Success"/>
</response>

The code element of the response XML file contains a status code and a message. The possible status codes are:

Code Message
100 Success
101 Failed, could not connect to database.
102 Failed, could not login with supplied login/password
104 Failed, not able to find the vehicle in the database
105 Failed, feature not supported on this vehicle
106 Failed, not able to connect to vehicle through cellular network

Test it here using your own information (may take up to 60 seconds to respond):

Login:
Password:
Serial # (7 digits):
State (0 to disable, 1 to enable):


© Copyright 2010 ProconGPS, Inc.  For technical support call 877-692-6966, email customer_support@procongps.com or fax 949-208-9871
Use of this Website constitutes acceptance of the SysLOCATE Terms of Use and Privacy Policy. Warranty.