Kom i gang med Instatus API

Alle endepunkter ligger under URL-en https://api.instatus.com. De følger stort sett REST-arkitekturen.

Alle forespørsler må kodes som JSON med headeren Content-Type: application/json.

Svar fra Instatus-API-et, inkludert feil, er også kodet som JSON.

Autentisering

Forespørsler til Instatus-API-et må oppgi et API-token i Authorization-headeren:

Du finner API-nøkkelen din under Brukerinnstillinger → Utviklerinnstillinger

Authorization: Bearer <API_KEY>

Finn side-ID-en din

Du finner side-ID-en din i dashbordet slik:

  1. Gå til dashbordet ditt.
  2. Høyreklikk på prosjektet ditt øverst til venstre for å åpne menyen.
  3. Klikk Kopier prosjekt-ID, så kopieres side-ID-en din til utklippstavlen.
Side-ID

Feil

Alle API-endepunkter returnerer en kode og en melding i feilsvarene.

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

Statusverdier

Mulige sidestatuser. Dette er den detaljerte status-verdien som returneres av det gjeldende API-et (v2 og nyere). Det gamle summary.json-endepunktet og webhook-varslinger bruker en forenklet form med bare UP, HASISSUES og UNDERMAINTENANCE.

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

Mulige komponentstatuser:

  • OPERATIONAL
  • UNDERMAINTENANCE
  • DEGRADEDPERFORMANCE
  • PARTIALOUTAGE
  • MAJOROUTAGE

Mulige hendelsesstatuser:

  • INVESTIGATING
  • IDENTIFIED
  • MONITORING
  • RESOLVED

Mulige vedlikeholdsstatuser:

  • NOTSTARTEDYET
  • INPROGRESS
  • COMPLETED

Hopp til endepunktene: