If called with the duration parameter, this API call is used to retrieve current drivers with HOS Log Violations and drivers at risk of going into violation for up to the duration specified. If called with the start and end parameters, this call will return all drivers who went into violation during the specified time period.
Required Information | |
---|---|
Name | Description |
action | adminhos |
operation | logviolations |
format | xml |
version | API protocol version - version 3 only |
start | UTC epoch, limit to 7 days of data |
end | UTC epoch, limit to 7 days of data |
Optional Information | |
target | A driver identifier to limit the results with
Must be used in conjunction with reqtype |
reqtype | A value used to interpret the target value. Valid options are:
|
Example Requests:
Using duration:
https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=adminhos&operation=logviolations&version=3&format=xml&duration=3600
Using start and end:
https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=adminhos&operation=logviolations&version=3&format=xml&&start=1556170925&end=1556318551
Violation codes:
- DR – 30 minute rest break violation
- DD – 11 hour violation
- DOD – 14 hour violation
- 7D – 60 hour violation
- 8D – 70 hour violation
Example Reply XML
<?xml version="1.0"?>
<violations>
<entry>
<name>John Doe</name>
<tagid>287079</tagid>
<exsid>GOOTOD</exsid>
<code>8D</code>
<start>2018-10-06 11:19:22-07</start>
<duration>4367.73 min</duration>
<type>In Violation</type>
<asset>P2121</asset>
</entry>
...
</violations>