Equipment Data API

TIP

Resources API should supply the Authorization parameter in the Header when making the request to ensure that right data are being returned.

Authorization

Parameter	Type	Required	Value
Authorization	String	Yes	Bearer {Access Token}

1.Get real-time equipment MCU data

Request Parameter

Parameter	Type	Required	Description
deviceList	Array<String>	Yes	Machine SN, one or more

Example

{
  "msg":"success",
  "code":200,
  "data":[
	{
		"fuelRemainingRatio": 100,// Units: %
		"serialNumber":"CLG922FZCNEXXXXX",
		"mcuDateTime": "2022-08-19T21:51:04.000+08:00",
		"hydraulicsTemp":31,// Units:°C
		"telematicsHardwareIDNum": "60306XXXX"
	} 
  ]
}

POST Get real-time equipment MCU data

https://ilinkopenapi.liugong.com/service/open/OpenOutImp/devsRealTimeMcu

2.Get real-time equipment engine data

Request Parameter

Parameter	Type	Required	Description
deviceList	Array<String>	Yes	Machine SN, one or more

Example

{
  "msg":"success",
  "code":200,
  "data":[
	   {
		"serialNumber": "CLG922FZPNEXXXXXXX",
		"cumulativeIdleHour": 0.65, // Units:Hr
		"cumulativeRegenerationHour": 6, // Units:Hr
		"engineDateTime": "2022-09-06T20:43:08.000+08:00",
		"fuelConsumed": 342, // Units:L
		"batteryVoltage": 28.15, // Units:V
		"cumulativeOperatingHours": 31, // Units:Hr
		"engineRunning": "4", //0:stop；1：ready；2: start；3：warm up；4：turn ove；5：High-Limit；6：ready to stop；7：Self-shield Type，0xFF:invalid
		"hydraulicsLevel": 12, // Units:%
		"telematicsHardwareIDNum": "60306XXXX",
         "engineSpeed": 1701.875
	   } 
	   
  ]
}

POST Get real-time equipment engine data

https://ilinkopenapi.liugong.com/service/open/OpenOutImp/devsRealTimeEngine

3.Last Known Location

Request Parameter

Parameter	Type	Required	Description
deviceList	Array<String>	Yes	Machine SN,input one or more

Example

{
  "total":"Number",
  "rows":[
    {
      "serialNumber": "CLG922FZCNEXXXXX",
      "latitude": 52.225133,
      "longitude": -0.2427,
      "altitude": 46,
      "telematicsHardwareIDNum": "60306XXXX",
      "dateTime": "2022-08-21T06:50:23.000+08:00"
    }
  ],
  "code": 200
}

POST Get Last Known Location

https://ilinkopenapi.liugong.com/service/open/OpenOutImp/getDeviceLastGps

4.Get history locations

Request Parameter

Parameter	Type	Required	Description
serialNumber	String	Yes	Machine SN Only one
startTime	Date	No	data from the current date to the day before as default
endTime	Date	No	data from the current date to the day before as default

Example

{
  "total": "513",
  "rows": [
    {
      "serialNumber": "CLG922FZCNEXXXXX",
      "latitude": 50.8237,
      "longitude": -1.056217,
      "altitude": 232,
      "telematicsHardwareIDNum": "60306XXXX",
      "dateTime": "2022-08-01T11:39:18.000+08:00"
    },
    {
      "serialNumber": "CLG922FZCNEXXXXX",
      "latitude": 50.8237,
      "longitude": -1.056217,
      "altitude": 245,
      "telematicsHardwareIDNum": "60306XXXX",
      "dateTime": "2022-08-01T15:45:40.000+08:00"
    },
   ...
  ],
  "code":200
}

POST Get equipment history locations

https://ilinkopenapi.liugong.com/service/open/OpenOutImp/getDeviceListGps

5.Equipment McuHistory Data

Request Parameter

Parameter	Type	Required	Description
deviceSn	String	Yes	Machine SN only one
startTime	Long	Yes	start time, millisecond timestamp
endTime	Long	Yes	end time, millisecond timestamp

Example

{
  "msg":"success",
  "code":200,
  "data":[
   {
   	"fuelRemainingRatio": 100,// Units:%
   	"serialNumber":"CLG922FZCNEXXXXX",
   	"mcuDateTime": "2022-08-22T21:51:04.000+08:00",
   	"hydraulicsTemp":33,// Units:°C
   	"telematicsHardwareIDNum": "60306XXXX"
   },
   {
   	"fuelRemainingRatio": 100,// Units:%
   	"serialNumber":"CLG922FZCNEXXXXX",
   	"mcuDateTime": "2022-08-23T21:51:04.000+08:00",
   	"hydraulicsTemp":33,// Units:°C
   	"telematicsHardwareIDNum": "60306XXXX"
   },
   ...

  ]
}

POST Get history data

https://ilinkopenapi.liugong.com/service/open/OpenOutImp/devMcuHistory

6.Equipment EngineHistory Data

Request Parameter

Parameter	Type	Required	Description
deviceSn	String	Yes	Machine SN only one
startTime	Long	Yes	start time, millisecond timestamp
endTime	Long	Yes	end time, millisecond timestamp

Example

{
  "msg":"success",
  "code":200,
  "data":[
   {
   		"serialNumber": "CLG922FZPNEXXXXXXX",
   		"cumulativeIdleHour": 0.65, // Units:Hr
   		"cumulativeRegenerationHour": 5, // Units:Hr
   		"engineDateTime": "2022-09-06T20:43:08.000+08:00",
   		"fuelConsumed": 342,// Units:L
   		"batteryVoltage": 28.15,// Units:V
   		"cumulativeOperatingHours": 31,// Units:Hr
   		"engineRunning": "4",//  //0:stop；1：ready；2: start；3：warm up；4：turn ove；5：High-Limit；6：ready to stop；7：Self-shield Type，0xFF:invalid
   		"hydraulicsLevel": 33,// Units:%
   		"telematicsHardwareIDNum": "60306XXXX",
      "engineSpeed": 1701.875
   },
	{
		"serialNumber": "CLG922FZPNEXXXXXXX",
		"cumulativeIdleHour": 0.65, // Units:Hr
		"cumulativeRegenerationHour": 2, // Units:Hr
		"engineDateTime": "2022-09-07T20:43:08.000+08:00",
		"fuelConsumed": 356,// Units:L
		"batteryVoltage": 29.15,// Units:V
		"cumulativeOperatingHours": 34,// Units:Hr
		"engineRunning": "5",//  //0:stop；1：ready；2: start；3：warm up；4：turn ove；5：High-Limit；6：ready to stop；7：Self-shield Type，0xFF:invalid
		"hydraulicsLevel": 32,// Units:%
		"telematicsHardwareIDNum": "60306XXXX",
     "engineSpeed": 1701.875
	},
	...

  ]
}

POST Get history data

https://ilinkopenapi.liugong.com/service/open/OpenOutImp/devEngineHistory