Super Monitoring API

Super Monitoring API allows retrieving historical monitoring data from www.supermonitoring.com.

Super Monitoring API 1.1 Documentation


Authentication

Super Monitoring API uses API Key to allow access to the API.
API Key is issued only for a specific IP address, that requests are going to come from.
Please contact Super Monitoring Support to obtain your API Key.

HTTP Request

MethodURL
GEThttp://www.supermonitoring.com/API/1.1/

Query Parameters

ParameterRequiredDefaultDescription
apikeyyes-The API Key.

Example: "4grf647e4tyrfg43663f"
urlyes-Encoded URL of the check, without "http://" or "https://".

Example: "www.mywebsite.com%2Ffolder"
fromyes-Starting date of the time range, using the time zone of the account.
Format: YYYY-MM-DD-HH-MM

Example: "2016-01-01-00-00"
toyes-Ending date of the time range, using the time zone of the account.
Format: YYYY-MM-DD-HH-MM

The time range is limited to maximum 1 year.

Example: "2016-01-26-23-59"
typenosIf set to "s" (or omitted) the result will include only a summary.
If set to "d" the result will include a summary plus a detailed list of outages.

Example: "s"

Example Queries


Example 1
http://www.supermonitoring.com/API/1.1/?apikey=4grf647e4tyrfg43663f&url=www.mywebsite.com%2Ffolder&from=2016-01-01-00-00&to=2016-01-26-23-59&type=s

Example 2
http://www.supermonitoring.com/API/1.1/?apikey=4grf647e4tyrfg43663f&url=www.mywebsite.com%2Ffolder&from=2016-01-01-00-00&to=2016-01-26-23-59&type=d

Response Format

Super Monitoring API responses come back as JSON.

Property NameDescription
ResponseCodeResponse status code - see below.
ResponseTextResponse status description - see below.
HostIP address the query was sent from (for reference).
OutagesTotal number of outages in the specified time range.
DowntimeTotal downtime (in minutes) in the specified time range.
EventsDetailed list of outages from the specified time range.
  eventIDOutage unique ID.
  eventStartOutage detection date & time, using the time zone of the account. Format: YYYY-MM-DD HH:MM
  eventDurationOutage duration (in minutes).
  eventErrorFailure type.
Possible failure types:
- http error codes, for example "HTTP 503"
- "CONNECTION TIMEOUT"
- "LOADING TIMEOUT"
- "NOPHRASE" (content & form monitoring error).

Response Codes & Texts

Super Monitoring API returns status codes together with short captions.

ResponseCodeResponseTextDescription
01OKAuthentication successful.
10AUTH FAILEDAuthentication failed. Provided apikey was invalid or the request came from a different IP address that the apikey had been generated for.
11URL NOT FOUNDNo check for given URL has been found on user account.

Hint: Make sure the URL is encoded and doesn't include "http://" or "https://".
12INCORRECT DATE RANGEDate & time in the "from" parameter is not earlier than the one in the "to" parameter - or one of the dates & time is not formatted properly.
13SERVICE BLOCKEDThe check or the account is inactive.
14RANGE LIMIT EXCEEDEDThe given time range is larger than 1 year.

Example Responses


Example 1: Authorization unsuccessful.
{
  "ResponseCode":10,
  "ResponseText":"AUTH FAILED",
  "Host":"78.10.233.131"
}

Example 2: Summary.
{
  "ResponseCode":"01",
  "ResponseText":"OK",
  "Host":"78.10.233.131",
  "Outages":12,
  "Downtime":142
}

Example 3: Summary + Detailed List.
{
  "ResponseCode":"01",
  "ResponseText":"OK",
  "Host":"78.10.233.131",
  "Outages":12,
  "Downtime":142,
  "Events":
    [
      {
        "eventID":"365257",
        "eventStart":"2016-01-04 10:54:47",
        "eventDuration":"8",
        "eventError":"HTTP 503"
      },
      {
        "eventID":"365287",
        "eventStart":"2016-01-04 14:18:48",
        "eventDuration":"1",
        "eventError":"CONNECTION TIMEOUT"
      },
      {
        "eventID":"366191",
        "eventStart":"2016-01-09 08:26:47",
        "eventDuration":"3",
        "eventError":"HTTP 503"
      },
      {
        "eventID":"368393",
        "eventStart":"2016-01-22 12:00:48",
        "eventDuration":"1",
        "eventError":"HTTP 500"
      }
    ]
}
This website uses cookie files to improve user experience . If you don't approve, please turn off the cookie usage in your browser settings. close