设备资源API

TIP

所以资源类API都需要在请求头中携带认证参数才可以正常返回。

认证参数

参数	类型	是否必须	值
Authorization	String	是	Bearer {Access Token}

1.获取设备实时Mcu数据

请求参数

参数	类型	是否必须	说明
deviceList	Array<String>	是	设备sn码

返回示例

{
  "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 获取设备实时Mcu数据

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

2.获取设备实时发动机数据

请求参数

参数	类型	是否必须	说明
deviceList	Array<String>	是	设备sn码

返回示例

{
  "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 获取设备实时发动机数据

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

3.获取当前设备定

请求参数

参数	类型	是否必须	说明
deviceList	Array	是	机器SN，输入一个或多个

返回示例

{
  "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 获取当前设备定位

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

4.获取设备历史轨迹

请求参数

参数	类型	是否必须	说明
serialNumber	String	是	机器序列号只有一个
startTime	Date	否	默认为从当前日期到前一天的数据
endTime	Date	否	默认为从当前日期到前一天的数据

返回示例

{
  "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 获取设备历史轨迹

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

5.获取mcu历史数据

请求参数

参数	类型	是否必须	说明
deviceSn	String	是	机器序列号只有一个
startTime	Long	是	开始时间，毫秒时间戳
endTime	Long	Yes	结束时间，毫秒时间戳

返回示例

{
  "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 获取mcu历史数据

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

6.获取发动机历史数据

请求参数

参数	类型	是否必须	说明
deviceSn	String	是	机器序列号只有一个
startTime	Long	是	开始时间，毫秒时间戳
endTime	Long	Yes	结束时间，毫秒时间戳

返回示例

{
  "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"
   },
	{
		"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 获取发动机历史数据

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