Kom godt i gang med Instatus API

Alle endpoints ligger under URL'en https://api.instatus.com. De følger overordnet set REST-arkitekturen.

Alle forespørgsler skal være kodet som JSON med headeren Content-Type: application/json.

Svar fra Instatus API, inklusive fejl, er ligeledes kodet som JSON.

Godkendelse

Forespørgsler til Instatus API skal indeholde et API-token i Authorization-headeren:

Du kan hente din API-nøgle under Brugerindstillinger → Udviklerindstillinger

Authorization: Bearer <API_KEY>

Find dit side-ID

Du finder dit side-ID i dashboardet på denne måde:

1. Gå til dit dashboard.
2. Højreklik på dit projekt i øverste venstre hjørne for at åbne menuen.
3. Klik på Kopiér projekt-ID, så bliver dit side-ID kopieret til udklipsholderen.

Fejl

Alle API-endpoints returnerer en kode og en besked i fejlsvarene.

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

Statusværdier

Mulige sidestatusser. Det er den detaljerede status, som det nuværende API (v2 og senere) returnerer. Det ældre summary.json-endpoint og webhook-notifikationer bruger en forenklet form med kun UP, HASISSUES og UNDERMAINTENANCE.

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

Mulige komponentstatusser:

• OPERATIONAL
• UNDERMAINTENANCE
• DEGRADEDPERFORMANCE
• PARTIALOUTAGE
• MAJOROUTAGE

Mulige hændelsesstatusser:

• INVESTIGATING
• IDENTIFIED
• MONITORING
• RESOLVED

Mulige vedligeholdelsesstatusser:

• NOTSTARTEDYET
• INPROGRESS
• COMPLETED

Spring til endpoints: