Vehicle Histroy Data with Status

This API is meant to return the history of the data of vehicle along with the status.

GEThttps://yourdomain.com/webservice?token=getVehicleHistoryDataWithStatus&vehname=XX&startdate=dd/mm/YYYY&enddate=dd/mm/YYYY&interval_ss=XX&accessToken=XX
Request Parameters
Parameter Type Value Description
vehnameStringVehicle name
startdateStringStart date
enddateStringEnd date
interval_ssStringInterval in seconds
accessTokenStringtoken
Description

Method

getVehicleHistoryDataWithStatus

Prerequisites

Before calling this API we need to call generateAccessToken API in order to generate the token.

Acceptance Criteria

Validation for each parameter or parameter description

  1. vehname

    1. It is the name of Vehicle.  

  2. interval_ss

                        1. Interval in seconds.



Response Description


Key

Format

Description

Vehicle Unique Id

String

Vehicle full name

Zone

String

Location name

Vehicle Category

String 

Vehicle brand and model

Speed

String

Vehicle speed

Date

string

Data received date

time

String

Data received time

Lat-Long

double

Vehicle latitude and longitude

Lat-Long Status

String

current/previous



Sample Response
Success message
[
  {
    "Vehicle Unique Id": " XXXX",
    "Zone": "XXXXXX",
    "Vehicle Category": "XX - XX",
    "Speed": "20",
    "Date": "",
    "Time": "",
    "Lat-Long": "25.22225-52.25585258",
    "Lat-Long Status": "current/previous"
  }
]
FAIL
[
   {
       "Error": "Token is invalid or expired"
   }
]
FAIL
[
   {
       "Error": "Insufficient request parameters"
   }
]
FAIL
[
   {
       "Error": "Invalid user"
   }
]
FAIL
[
   {
       "Error": "User license expired"
   }
]
FAIL
[
   {
       "Error": "Vehicle not found"
   }
]
FAIL
[
   {
       "Error": "You do not have rights of this vehicle"
   }
]
FAIL
[
   {
       "Error": "Vehicle license is expired"
   }
]
FAIL
[
   {
       "Error": "You can not request data for duration of more than 24 hour."
   }
]
FAIL
[
   {
       "Error": "No data found"
   }
]
FAIL
[
   {
       "Error": "something went wrong on server"
   }
]
Response codes
Code Description
Error codes
Code Name Description