Super Monitoring API

Super Monitoring API umożliwia pobieranie historycznych danych monitoringowych z serwisu www.supermonitoring.pl.

Dokumentacja Super Monitoring API 1.1


Uwierzytelnienie

Dostęp do Super Monitoring API udzielany jest w oparciu o Klucz API.
Klucz API generowany jest tylko dla konkretnego adresu IP, z którego następować będą połączenia do API.
W celu uzyskania Klucza API prosimy o kontakt obsługą klienta Super Monitoring.

Zapytanie HTTP

MetodaAdres URL
GEThttp://www.supermonitoring.pl/API/1.1/

Parametry zapytania

ParametrWymaganyDomyślnieOpis
apikeytak-Klucz API.

Przykład: " 4grf647e4tyrfg43663f"
urltak-Enkodowany adres URL testu, bez "http://" or "https://".

Przykład: "www.mojastrona.pl%2Ffolder"
fromtak-Data początkowa okresu.
Format: YYYY-MM-DD-HH-MM

Przykład: "2016-01-01-00-00"
totak-Data końcowa okresu.
Format: YYYY-MM-DD-HH-MM

Okres jest ograniczony do maksymalnie 1 roku.

Przykład: "2016-01-26-23-59"
typeniesPrzy wartości "s" (lub braku tego parametru) wynik będzie zawierał tylko podsumowanie.
Dla wartości "d" wynik będzie zawierał podsumowanie oraz szczegółową listę awarii.

Przykład: "s"

Przykładowe zapytania


Przykład 1
http://www.supermonitoring.pl/API/1.1/?apikey=4grf647e4tyrfg43663f&url=www.mojastrona.pl%2Ffolder&from=2016-01-01-00-00&to=2016-01-26-23-59&type=s

Przykład 2
http://www.supermonitoring.pl/API/1.1/?apikey=4grf647e4tyrfg43663f&url=www.mojastrona.pl%2Ffolder&from=2016-01-01-00-00&to=2016-01-26-23-59&type=d

Schemat odpowiedzi

Super Monitoring API zwraca odpowiedzi w formacie JSON.

Nazwa polaOpis
ResponseCodeKod statusu odpowiedzi - patrz niżej.
ResponseTextOpis słowny statusu odpowiedzi - patrz niżej.
HostAdres IP, z którego przyszło zapytanie (informacyjnie).
OutagesCałkowita liczba awarii w danym okresie.
DowntimeŁączny czas niedostępności (w minutach) w danym okresie.
EventsSzczegółowa lista awarii z danego okresu.
  eventIDUnikalny identyfikator awarii.
  eventStartData i czas wykrycia awarii. Format: YYYY-MM-DD HH:MM
  eventDurationCzas trwania awarii (w minutach).
  eventErrorRodzaj awarii.
Możliwe rodzaje awarii:
- kody błędów http, np. "HTTP 503"
- "CONNECTION TIMEOUT"
- "LOADING TIMEOUT"
- "NOPHRASE" (w przypadku monitorowania treści lubn formularza).

Kody i opisy statusów odpowiedzi

Super Monitoring API zwraca kody statusów razem z krótkimi opisami słownymi.

ResponseCodeResponseTextObjaśnienie
01OKUdane uwierzytelnienie.
10AUTH FAILEDUwierzytelnienie nieudane. Podany apikey jest nieprawidłowy lub zapytanie przyszło z innego adresu IP niż ten, dla którego apikey został wygenerowany.
11URL NOT FOUNDNa koncie użytkownika nie odnaleziono testu z podanym adresem URL.

Podpowiedź: Upewnij się, że adres URL jest enkodowany oraz nie zawiera http://" ani "https://".
12INCORRECT DATE RANGEData i czas w parapetrze "od" nie jest wcześniejsza od daty i czasu w parametrze "do" - lub jeden z tych parmetrów nie jest prawidłowo sformatowany.
13SERVICE BLOCKEDDany test lub konto są nieaktywne.
14RANGE LIMIT EXCEEDEDPodany okres jest dłuższy niż 1 rok.

Przykładowe odpowiedzi


Przykład 1: Nieudane uwierzytelnienie.
{
  "ResponseCode":10,
  "ResponseText":"AUTH FAILED",
  "Host":"78.10.233.131"
}

Przykład 2: Podsumowanie.
{
  "ResponseCode":"01",
  "ResponseText":"OK",
  "Host":"78.10.233.131",
  "Outages":12,
  "Downtime":142
}

Przykład 3: Podsumowanie + szczegółowa lista.
{
  "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"
      }
    ]
}
Ta strona wykorzystuje pliki typu cookie. Jeżeli nie wyrażasz zgody na ich zapisywanie, wyłącz ich obsługę w ustawieniach swojej przeglądarki. zamknij