GET
/machines/{id}/hoursOfOperation
Hours of Operation
Become a beta tester for MachineMonitoring resources.
GET /machines /{id} /hoursOfOperation
Hours of Operation
The Hours of Operation service allows the user to view the durations for which the engine was on or off during a specified time period. You will also be able to view the last known state of the machine's engine. Each request returns a link to machine, which will return a state report for the specified machine.
Note: When the terminal is powered off, hours of operation are not recorded.
 
Request URI
GET https://apicert.soa-proxy.deere.com/platform/machines/{id}/hoursOfOperation
Accept: application/vnd.deere.axiom.v3+xml OR application/vnd.deere.axiom.v3+json
 
Request Parameters
Parameter Type Example Description Default Required?
startDate dateTime 2013-04-29T00:00:00Z Filters hours of operation starting from a specified date. Request date as UTC Timestamp. N/A No.
endDate dateTime 2013-04-30T23:30:00Z Filters hours of operation before a specified date. Request date as UTC Timestamp. N/A No.
 
Response Details
Field Type Example Description
startDate dateTime 2013-04-29T00:00:00Z Time at which the machine started. Returns a UTC Timestamp.
endDate dateTime 2013-04-30T23:30:00Z Time at which the machine stopped. Returns a UTC Timestamp.
engineState integer 1 The returned value indicates the current state of the engine.1
 
Sample Response [JSON]
GET https://apicert.soa-proxy.deere.com/platform/machines/5432/hoursOfOperation
200 OK
Content-Type: application/vnd.deere.axiom.v3+json;charset=UTF-8

{
   "links": [
      {
         "rel": "self",
         "uri": "https://apicert.soa-proxy.deere.com/platform/machines/5432/hoursOfOperation"
      }
   ],
   "total": 2,
   "values": [
      {
         "links": [
            {
               "rel": "machine",
               "uri": "https://apicert.soa-proxy.deere.com/platform/machines/5432"
            }
         ],
         "startDate": "2013-04-29T00:00:00Z",
         "endDate": "2013-04-30T00:00:00Z",
         "engineState": 0
      },
      {
         "links": [
            {
               "rel": "machine",
               "uri": "https://apicert.soa-proxy.deere.com/platform/machines/5432"
            }
         ],
         "startDate": "2013-04-29T00:00:00Z",
         "endDate": "2013-04-30T00:00:00Z",
         "engineState": 0
      }
   ]
}
 
[1]
Number Engine State
0 The power-on key is ON.
1 The power-on key is OFF.
2 The terminal is SLEEPING.
3 The terminal is HIBERNATING.