OmniCenter’s API system must be enabled to use this API. See, How to Enable OmniCenter API Access.
Calls to this API are made using HTTP/HTTPS and are sent as key/value pairs in a GET or POST request.
The resource accessed by this API is the state of an OmniCenter incident. Incidents are how OmniCenter tracks problems in your network. Acknowledging an incident lets everyone involved know that someone is working on the problem.
This resource offers the following endpoints:
- Acknowledge Incident
GET or POST
Sets the incident state of the specified incident to ACKNOWLEDGED.
The parameters for this endpoint can be included as query string parameters in a GET request, or as request body parameters in a POST request.
String/Required if authentication is enabled.
The API key set in OmniCenter’s API Administration. Case-sensitive.
The unique identifier assigned to the incident by OmniCenter.
A name to associate this acknowledgement action with. Does not have to match an existing username in OmniCenter to be accepted (so an automated value like “Ticketing System” is acceptable).
A comment that will be added to the record of the acknowledgement in OmniCenter and sent out in any acknowledgement alerts. Limit of 255 characters.
Acknowledge Using GET with API Authentication Disabled
http://126.96.36.199/utils/incident_ack.php?incident_id=111-S-937182322&ack_user=administrator&ack_comment=Ticket 2074 created and assigned to jsmith
Acknowledge Using GET with API Authentication Enabled
http://188.8.131.52/utils/incident_ack.php?incident_id=111-S-937182322&ack_user=administrator&ack_comment=Ticket 2074 created and assigned to jsmith&password=PassWord1234
A successful call to this API will return a single binary value.
||number||Indicates the acknowledgement failed.|
||number||Indicates the acknowledgement was successful.|