HOS Log Violations

This API call is used to retrieve HOS Log Violations for a given driver over a time frame of up to one week.

Request Data

Required Information
Name	Description
action	adminhos
operation	logviolations
format	xml
version	API protocol version - version 2 only
target	A driver identifier to limit the results with Note: must be used in conjunction with reqtype
reqtype	A value used to interperet the target value. Valid options are: dbid - The Zonar database id for the driver. tagid - The tagid assigned to the driver. exsid - The exsid assigned to the driver.
startepoch	Time stamp for the beginning of the query period. Note: The total query period cannot exceed one week.
endepoch	Time stamp for the end of the query period. Note: The total query period cannot exceed one week.

 

Example Request

https://test.zonarsystems.net/interface.php?action=adminhos&operation=logviolations&version=2 &format=xml&target=1&reqtype=dbid&start=1379108541&end=1379109000

 

Returned Information

DTD

<!ELEMENT violations (entry*)>
<!ELEMENT entry(duration, start, type)>
<!ELEMENT duration(#PCDATA)>
<!ELEMENT start(#PCDATA)>
<!ELEMENT type (#PCDATA)>

Example Reply XML

<?xml version ="1.0"?>
<violations>
     <entry>
         <duration>250</duration>
         <start>1379108900</start>
         <type>DD</type>
     </entry>
</violations>