Kom igång med Instatus API

Alla endpoints finns under URL:en https://api.instatus.com. De följer i stort sett REST-arkitekturen.

Alla anrop måste vara kodade som JSON med headern Content-Type: application/json.

Svaren från Instatus API, inklusive fel, är också kodade som JSON.

Autentisering

Anrop till Instatus API måste skicka med en API-token via Authorization-headern:

Du hittar din API-nyckel under Användarinställningar → Utvecklarinställningar

Authorization: Bearer <API_KEY>

Hämta ditt sid-ID

Du hittar ditt sid-ID i dashboarden så här:

  1. Gå till din dashboard.
  2. Högerklicka på ditt projekt uppe till vänster för att öppna menyn.
  3. Klicka på Kopiera projekt-ID så kopieras ditt sid-ID till urklipp.
Sid-ID

Fel

Alla API-endpoints innehåller en kod och ett meddelande i felsvaren.

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

Statusvärden

Möjliga sidstatusar. Det här är den detaljerade status som returneras av det nuvarande API:et (v2 och senare). Den äldre endpointen summary.json och webhook-aviseringar använder en förenklad form med bara UP, HASISSUES och UNDERMAINTENANCE.

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

Möjliga komponentstatusar:

  • OPERATIONAL
  • UNDERMAINTENANCE
  • DEGRADEDPERFORMANCE
  • PARTIALOUTAGE
  • MAJOROUTAGE

Möjliga incidentstatusar:

  • INVESTIGATING
  • IDENTIFIED
  • MONITORING
  • RESOLVED

Möjliga underhållsstatusar:

  • NOTSTARTEDYET
  • INPROGRESS
  • COMPLETED

Hoppa till endpoints: