Please contact technical support to enable access to the API from your IP addresses.

There are several ways for you to view and interact with your monitoring data beyond the website interface, including using the XML feed to consume data and interacting with the API to monitor and update your monitoring agents.

With the XML feed, you can subscribe to the data you want and present it in your own format using your own custom reports.

Using the API you can interact with your monitoring tools using simple HTTPS requests to update the details of your monitored devices.

Custom Collector API
Separate MetricsView API is a set of methods for uploading any metrics from any source regardless of a platform into Dotcom-Monitor inc. for further processing and analysis.

You can create your own custom scripts or applications to interact with the settings and view the monitored data in your own customized environment.

The Dotcom-Monitor API is broken out into 10 resource types:

Platform: All monitoring tasks fall into one of five different platforms.

Devices: A monitored device is an organized “set” of monitoring tasks that contains either a single monitoring task, a sequence of monitoring tasks, a monitoring script that includes tasks, or a combination of all three.

Tasks: A task is any single monitoring action, such as monitoring a target (URL, Mail Server, FTP Server, etc).

Frequency: Defines how often monitoring sessions will be executed.

Scheduler: A scheduler details when a task will or will not be run.

Location: A monitoring location available within the Dotcom-Monitor worldwide monitoring network.

Alert Group: Setting up a group places recipients of a report and/or alert into a group. Each recipient in the group can have a unique alert template.

Alert Template: Template defines alerts format.

Filter: A Filter is a set of rules, which determine how monitoring responses are processed and displayed.

Audit: Provides historical information on each and any account modification.

The API uses JSON as a data format throughout the service, both for input and output. An app must set the Content-Type HTTP header to “application/json” if and only if it’s sending JSON in the request body.

The Dotcom-Monitor API is served over HTTP/HTTPS.

Base URL

All URLs referenced in the document have the following base:
  • All read methods are HTTP/HTTPS GET requests.
  • All write methods are HTTP/HTTPS POST requests.
  • All requests require preliminary authentication.
  • Requests and responses are given in JSON.
You need to be authenticated before any API request. Authentication expires after 60 seconds of inactivity

The table below shows which request type and action is supported by each resource type.

Resource type Request Method URI(s) Description
Platform GET /platforms Return list of available platforms
Device GET /devices/{platform} Get device list by platform.
GET /device/{deviceId} Get Device info
POST /devices?verb=PUT Create New Device
PUT /devices
POST /device/{deviceId}/DisableAlert/ Disable Alerts
POST /device/{deviceId} Edit Device
POST /device/{deviceId}?verb=delete Delete Device
DELETE /device/{deviceId}
Task GET /device/{deviceid}/tasks Get list of tasks under a device
POST /tasks?verb=PUT Create new task
PUT /tasks
GET /task/{TaskId} Get task info
POST /task/{TaskId} Edit task
POST /task/{TaskId}?verb=delete Delete task
DELETE /task/{TaskId}
Frequency GET /frequencies/{platform_name} Get available freq. by platform.
Scheduler GET /schedulers Get list of schedulers
GET /Scheduler/{Scheduler_ID} Get specific scheduler info
POST /schedulers?verb=PUT Create new scheduler
PUT schedulers
POST /scheduler/{ scheduler ID} Edit scheduler
POST /Scheduler/{Scheduler_Id}?verb=delete Delete scheduler
DELETE /Scheduler/{Scheduler_Id}
Location GET /locations/{platform_name} Get list of available locations
Alert Group GET /groups Get list of alert groups
POST /groups?verb=PUT/groups Create alert group
PUT groups/groups
GET /Group/{Group_ID} Get alert group info
POST /Group/{Group_ID} Edit alert group
POST /Group/{Group_Id}?verb=delete Delete group
DELETE Group/{Group_Id}
Alert template GET /templates Get list of alert templates
POST /templates?verb=PUT/templates Create new alert template
PUT /templates/templates
GET /template/{Template_ID} Get alert template info
POST /template/{Template_ID} Edit alert template
POST /template/{Template_Id}?verb=delete Delete template
DELETE /template/{Template_Id}
Filter GET /filters Get list of filters
POST /filters?verb=PUT Create new filter
PUT /filters
GET /filter/{filter_ID} Get specific filter information
POST /filter/{filter_ID} Edit filter
POST /filter/{filter_ID}?verb=delete Delete filter
DELETE /filter/{filter_ID}
Audit GET /audit/list Get list audited objects for current user for the last 24h.
GET /audit/object/{sample ID} Get contents of audit for the particular ID
POST /audit/list Get filtered list of audited objects.