Zacznij korzystać z API Instatus

Wszystkie endpointy znajdują się pod adresem https://api.instatus.com. Zasadniczo są zgodne z architekturą REST.

Wszystkie żądania muszą być zakodowane jako JSON, z nagłówkiem Content-Type: application/json.

Odpowiedzi API Instatus, łącznie z błędami, również są kodowane jako JSON.

Uwierzytelnianie

Żądania do API Instatus muszą przekazywać token API w nagłówku Authorization:

Swój klucz API znajdziesz w Ustawieniach użytkownika → Ustawienia dewelopera

Authorization: Bearer <API_KEY>

Znajdź swoje ID strony

ID strony znajdziesz w panelu, wykonując poniższe kroki:

  1. Przejdź do swojego panelu.
  2. Kliknij projekt w lewym górnym rogu prawym przyciskiem myszy, aby otworzyć menu.
  3. Kliknij Copy Project ID, a ID strony zostanie skopiowane do schowka.
ID strony

Błędy

Wszystkie endpointy API zwracają w odpowiedziach błędu kod i komunikat.

{
"error": {
"code": "forbidden",
"message": "Not authorized"
}
}

Wartości statusów

Możliwe statusy strony. To szczegółowy status zwracany przez bieżące API (v2 i nowsze). Starszy endpoint summary.json oraz powiadomienia webhook używają formy skróconej, obejmującej tylko UP, HASISSUES i UNDERMAINTENANCE.

  • UP
  • HASISSUES
  • ALLUNDERMAINTENANCE
  • ALLDEGRADEDPERFORMANCE
  • ALLPARTIALOUTAGE
  • ALLMINOROUTAGE
  • ALLMAJOROUTAGE
  • SOMEUNDERMAINTENANCE
  • SOMEDEGRADEDPERFORMANCE
  • SOMEPARTIALOUTAGE
  • SOMEMINOROUTAGE
  • SOMEMAJOROUTAGE
  • ONEUNDERMAINTENANCE
  • ONEDEGRADEDPERFORMANCE
  • ONEPARTIALOUTAGE
  • ONEMINOROUTAGE
  • ONEMAJOROUTAGE

Możliwe statusy komponentu:

  • OPERATIONAL
  • UNDERMAINTENANCE
  • DEGRADEDPERFORMANCE
  • PARTIALOUTAGE
  • MAJOROUTAGE

Możliwe statusy incydentu:

  • INVESTIGATING
  • IDENTIFIED
  • MONITORING
  • RESOLVED

Możliwe statusy przerwy technicznej:

  • NOTSTARTEDYET
  • INPROGRESS
  • COMPLETED

Przejdź do endpointów: