e-mail:
voice:
360.854.9559
fax:
866.783.1742
I/O Sentinel 4 G2 Installation and Operation Manual
36
APPENDIX
Broadcast Tools HTTP/CGI Interface
To communicate with a Broadcast Tools Sentinel Product using the HTTP protocol, the following steps must be
performed:
Login and Authentication
All products require authorization before data can be sent/retrieved from the device. Authentication is performed
by POSTing the following data to 'cgi-bin/postauth.cgi'
LoginUser=<username>
LoginPass=<password>
AccessVal=0
For Example: LoginUser=admin&LoginPass=1234&AccessVal=0
The reply to the authentication POST will provide you with a session cookie, this cookie must be sent in all
future HTTP GET or POST requests, failure to do so will result in 401 error code.
Getting Data
Data is retrieved from the Broadcast Tools Sentinel device by use of the HTTP GET protocol, you must have
already been successfully authenticated and provided a cookie, this cookie must be transmitted in the header of
each GET request. All data returned from a valid GET request is in JSON format and varies between the devices
depending on what features they support. The following are standard files.
cgi-bin/getexchanger.cgi -- Basic device configuration, Site ID, Network Settings, etc. This is data that does not
change often, unless POST'ed by the user
cgi-bin/getexchanger_monitor.cgi -- Basic monitoring status, this contains data that reflects the inputs the device
is monitoring
cgi-bin/getexchanger_user.cgi -- Contains user login credentials, must have administrative rights to retrieve this file
cgi-bin/getexchanger_logs.cgi -- contains log details
Posting Data
Data is modified on the Broadcast Tools Sentinel device by the use of the HTTP POST protocol, you must have
already been successfully authenticated and provided a cookie, this cookie must be transmitted in the header of
each POST request. In addition, to change typical settings you must have access of Monitor/Control or
Administrative rights. To change user credentials you must have Administrative rights.
All data is sent as a normal POST (key=value&key=value) format to 'cgi-bin/postexchanger.cgi'.
The data posted varies by the device, however most data from getexchanger.cgi can be posted.
