Our GPS Fleet Software has a JSON API interface in order to integrate with 3rd party software solutions (ERP, etc.). The API JSON interface works for our web-based hosting accounts as well as for local server customers (if the network allows it).

The availabilty of the JSON interface depends on our offers and standard conditions. Please contact your provider for more information.

 

How to access the API

The API can only be used with an APIKEY that can only be set by our support.

http://XXX.sw-management.at/GFS/api/std/checkuser?apikey=apikey

The above command will return OK or ERROR if the apikey is correct or invalid (link must be changed).

{"info":"ok"} or {"error":"100"}

How to find the different JSON calls and paramenters

Developers can acces the WADL document on our hosting server (or on the local server of the customer):

http://gfs2.sw-management.at/GFS/api/application.wadl

The WADL document explains the calls and parameters in detail, such as the following example:

<resource path="/std">
 <resource path="/checkuser">
 <method id="checkuser" name="GET">
 <request>
<param xmlns:xs="http://www.w3.org/2001/XMLSchema" name="apikey" style="query" type="xs:string"/>
</request>
 <response>
<representation mediaType="application/json"/>
</response>
</method>
</resource>

Basic examples

 

Query for existing assets

Use the the following http call to query which assets are in a customer account. You will need the assetIDs for other commands.

https://XXX.sw-management.at/GFS/api/masterdata/gps/getAssetStates?apikey=ENTERYOURSECID&langid=2

xxx ... replace the link

ENTERYOURSECID ... the APIKEY that is set for the account


Get the current position

https://XXX.sw-management.at/GFS/api/masterdata/gps/getLastpos_for_assetid?apikey=ENERYOURSECID&assetid=YYYY

xxx ... replace the link

ENTERYOURSECID ... the APIKEY that is set for the account

YYYY ... assetid


Get historic trips

https://XXX.sw-management.at/GFS/api/masterdata/gps/getGpsHistory?apikey=ENTERYOURSECID&limit=300

xxx ... replace the link

ENTERYOURSECID ... the APIKEY that is set for the account


Get drivers

https://XXX.sw-management.at/GFS/api/masterdata/driver/getDrivers?apikey=ENTERYOURSECID

Get logbook entries

https://XXX.sw-management.at/GFS/api/masterdata/logbook/getLogbookData_for_assetid?apikey=ENTERYOURSECID&assetid=YYYY&showprivate=true&trips=true&stops=false&opt_datestr_from_yyyyMMddhhmmss=20171013000000