StartTrip

Description：

• Request for start trip

Version：

Request URL:

• http://icloud.assetscontrols.com:8092/api/AscentPH/StartTrip

Request Method：

• POST

Request Header：

Request Parameter:

Return Example:

Return when correct:

{
    "Result": 200,
    "Message": "success",
    "FObject": null
}

Return on error:

Error message explanation: The passed parameter tripId is empty.
{
    "Result": 105,
    "Message": "Fail:tripId is null",
    "FObject": null
}

Error message description: Incorrect token ID, or database connection timed out.
{
    "Result": 105,
    "Message": "Fail:token error or timeout",
    "FObject": null
}

Error message: This waybill is not bound to a device number and is prohibited from being dispatched.
{
    "Result": 105,
    "Message": "Fail:GetCurrentDeviceInfo- no device is bound to this trip ID",
    "FObject": null
}

Error message: This waybill device is unlocked, forbid to start trip.
{
    "Result": 105,
    "Message": "Fail:GetCurrentDeviceInfo- device is unlocked, forbid to start trip",
    "FObject": null
}

Error message: This device is offline and unlocking is prohibited.
{
    "Result": 105,
    "Message": "Fail:GetCurrentDeviceInfo-  asset offline",
    "FObject": null
}

Error message explanation: The passed tripId cannot be found in the database.
{
    "Result": 105,
    "Message": "Fail:GetCurrentDeviceInfo- without this trip ID",
    "FObject": null
}
Error message description: Background analysis program failed to start. 
{
    "Result": 105,
    "Message": "Fail:StartJourney- start analysis fail",
    "FObject": null
}
Error message explanation: Other undefined errors,need to contact Jointech.
{
    "Result": 105,
    "Message": "Fail:other",
    "FObject": null 
}

Return Parameter Description:

Request Example:

String result = "";
//request url
String url ="http://icloud.assetscontrols.com:8092/api/AscentPH/StartTrip?tripId=BOC-A-12312021-0002&fTokenID=DB7F20D9-84C3-44C3-B05A-06A9C392A189";
//Create post request object
  HttpPost post = new HttpPost(url);
 CloseableHttpClient client = HttpClients.createDefault();
 //Start the execution request and get the return value
 HttpResponse response = client.execute(post);
 //Get the returned entity object
HttpEntity entity = response.getEntity();
//Convert entity object to string
String result = EntityUtils.toString(entity, "UTF-8");
 return result;