Public API for NMIS configuration. "omk/admin/api/v2/"
We can manage the Administration Configuration resources below using this API:these endpoints - http://host
/en/omk/admin/api/v2/resource
Resource is our term for items in a configuration file or database.
Our current resource list consists of locations, contacts, services, escalations, events, polling-policy, users, access, customers and businessservices.
The resources can be accessed using the web interface or the API.
API Routes
Each resource has a consistent set of operations
Request Method |
---|
Operation | URL Example | id required | Notes | |
---|---|---|---|---|
POST |
create | /resource | n | Insert a new resource. |
GET |
read |
list | /resource |
n | Returns |
a list of resources. |
GET |
read |
one | /resource/id | y | Returns |
the details of a resource. |
PUT |
update | /resource/id | y | Update the details of a resource. |
DELETE |
delete | /resource/id | y | Delete a resource. |
API for Resources: | Locations | Services | Contacts |
---|
Escalations | Events | Polling-Policy | Users | Access | Customers | BusinessServices |
---|
This API can help you to manage the below operations for the given admin configurations. (Please see the link for All System Admin Configurations).
...
Operation | Method | URL | Example | ||
---|---|---|---|---|---|
Authenticate | POST | http://host/en/omk/admin/login |
|
We should receive a 200 response and a cookie, that we can reuse for next API calls.
...
Resource | Operation | Method | URL | Response | Example | |||||
---|---|---|---|---|---|---|---|---|---|---|
Locations | Create | POST | http://host/en/omk/admin/api/v2/locations.json | New Location in NMIS configurations. | http://apollo.opmantek.net:8080/en/omk/admin/api/v2/locations.json
| |||||
Locations | Read list | GET | http://host/en/omk/admin/api/v2/locations.json | Locations present in NMIS configuration file. | NEED AN EXAMPLE
| |||||
Locations | Read one | GET | http://host/en/omk/admin/api/v2/locations/{location-name}.json | Locations present in NMIS configuration file. | http://apollo.opmantek.net:8080/en/omk/admin/api/v2/locations/Amsterdam.json
| |||||
Locations | Update | PUT | http://host/en/omk/admin/api/v2/locations/{location-name}.json | Updated location entry | http://apollo.opmantek.net:8080/en/omk/admin/api/v2/locations/Mandatory%20param.json
| |||||
Locations | Delete | DELETE | http://host/en/omk/admin/api/v2/locations/{location-name}.json | Deletes the location entry from configurations | http://apollo.opmantek.net:8080/en/omk/admin/api/v2/locations/Mandatory%20param.json
|
...