The JumpDrive Partner API function “getInventoryData” allows partners to access current inventory data about vehicles using the 1st generation JD vehicle device.
Getting Started
Our Partner API requires the following to retrieve vehicle data:
- API URL, Username and Password (please email partner@jumpdrive.com for API URL and your credentials)
- Vehicle Identification Number (VIN)
- Familiarity with a programming language supporting REST calls (PHP, Ruby, .NET, Python, etc.)
For best results, we recommend querying the API during the check out process on demand.
Steps For Using the API
- Create a script to call our API URL (will be provided via email upon request) and pass your username, password, VIN and response format. By default all results are in XML, for example – getInventoryData(username, password, VIN, format). For JSON formatted results, use getInventoryData(username, password, VIN, ‘json’) and for XML formatted results use getInventoryData(username, password, VIN, ‘xml’).
- If you receive the message “Invalid Username and/or Password”, please contact partner@jumpdrive.com and we will confirm your credentials.
Sample XML/JSON results
Sample XML Response
<?xml version="1.0" encoding="UTF-8"?> <root> <VIN>5GAKRBED0BJ315901</VIN> <JumpDriveID>ffff31</JumpDriveID> <LotID>218</LotID> <LotName>Pine Ridge</LotName> <LastTimeIn>2015-04-11 13:01:48</LastTimeIn> <StartMileage>42646</StartMileage> <LastMileage>36645</LastMileage> <FuelPercent>34.48</FuelPercent> <FuelVolume>20.88</FuelVolume> <Battery>13.13</Battery> <Longitude>-79.519729614258</Longitude> <Latitude>8.9935998916626</Latitude> <IndoorLocation>B216</IndoorLocation> <Damage1Count>12</Damage1Count> <Damage2Count>2</Damage2Count> <Speeding1Count>344</Speeding1Count> <Speeding2Count>10</Speeding2Count> </root>
Sample JSON Response
[{"VIN":"5GAKRBED0BJ315901","JumpDriveID":"ffff31","LotID":"218","LotName":"Pine Ridge","LastTimeIn":"2015-04-11 13:01:48","StartMileage":"42646","LastMileage":"36645","FuelPercent":"34.48","FuelVolume":"20.88","Battery":"13.13","Longitude":"-79.519729614258","Latitude": "8.9935998916626","IndoorLocation":"B216","Damage1Count":"12","Damage2Count":"2","Speeding1Count":"344","Speeding2Count":"10"}]
Description Of Each Field Showing In XML/JSON Responses Above
- VIN = Vehicle Identification Number
- JumpDriveID = JumpDrive device ID assigned to each customer
- LotID = ID of the current location of the vehicle
- LotName = Name of the current location of the vehicle
- LastTimeIn = Most recent time when vehicle checked in (in local time zone)
- StartMileage = Starting mileage (in km) of vehicle when it was registered with a JumpDrive Vehicle Device. If this value is 0, the vehicle mileage was not registered and mileage value will not be up to date.
- LastMileage = Latest vehicle mileage (in km)
- FuelPercent = Current percentage of fuel tank full (100% is full, 0% is empty)
- FuelVolume = Current fuel volume in fuel tank, in liters
- Battery = Current battery level reported by vehicle in V
- Longitude = Current longitude value reported by vehicle
- Latitude = Current latitude value reported by vehicle
- IndoorLocation = Indoor slot or zone based on indoor sensor network
- Damage1Count = Total number of possible damage impact events on this vehicle
- Damage2Count = Total number of likely damage impact events on this vehicle
- Speeding1Count = Total number of seconds of speeding between 85mph and 99mph
- Speeding2Count = Total number of seconds of speeding 100mph and above
Additional questions?
Please email support@jumpdrive.com if you have any questions or require additional support.