Acknowledging with HTTP

You can perform a Basic Acknowledgement of a device by issuing a POST to a URL of this format:

http://imserver:port/mapid/device/deviceIMID/*acknowledge.cgi?message=URL+encoded+string

where:

• mapid = the mapid of the corresponding map.
• deviceIMID = the IMID of the device you wish to acknowledge.
• message: requires a URL-encoded text string

There are several ways of finding these values:

• Look in the web interface at the status window for a device, remove the trailing "!device.html" at the end, and replace that with "*acknowledge.cgi?message=....".
• Review the device table (you can view it using the HTTP API) and get the MapId and IMID.

Example: This curl command sends the POST with the proper string to acknowledge the device:

curl --user admin:Pa55w0rd http://imserver:port/mapid/device/deviceIMID/*acknowledge.cgi?message=URL+encoded+text+string -d "dummy post data"
        

Example: This curl command retrieves the full list of devices and each device's address, MapID and IMID

curl --user admin:Pa55w0rd http://imserver:port/~export/devices.tab?fields=MapId,IMID,address,name
        

Example: You can also use this expression in Python to create the URL to POST:

"http://imserver:port/%s/device/%s/*acknowledge.cgi?message=%s"  % (mapId, IMID,urllib.urlencode([('message', messageStr)]))