Inizia con l'API di Instatus

Tutti gli endpoint si trovano all'URL https://api.instatus.com. In genere seguono l'architettura REST.

Tutte le richieste devono essere codificate in JSON con l'header Content-Type: application/json.

Anche le risposte dell'API di Instatus, errori compresi, sono codificate in JSON.

Autenticazione

Le richieste all'API di Instatus devono fornire un token API tramite l'header Authorization:

Puoi ottenere la tua chiave API da Impostazioni utente → Impostazioni per sviluppatori

Authorization: Bearer <API_KEY>

Trova il tuo ID pagina

Puoi trovare l'ID pagina nella dashboard seguendo questi passaggi:

  1. Vai alla tua dashboard.
  2. Fai clic destro sul progetto in alto a sinistra per aprire il menu.
  3. Clicca su Copia ID progetto: l'ID della pagina viene copiato negli appunti.
ID pagina

Errori

Tutti gli endpoint dell'API includono un codice e un messaggio nelle risposte di errore.

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

Valori di stato

Stati possibili della pagina. È il valore status dettagliato restituito dall'API attuale (v2 e successive). L'endpoint legacy summary.json e le notifiche webhook usano una forma ridotta con soli UP, HASISSUES e UNDERMAINTENANCE.

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

Stati possibili dei componenti:

  • OPERATIONAL
  • UNDERMAINTENANCE
  • DEGRADEDPERFORMANCE
  • PARTIALOUTAGE
  • MAJOROUTAGE

Stati possibili degli incidenti:

  • INVESTIGATING
  • IDENTIFIED
  • MONITORING
  • RESOLVED

Stati possibili delle manutenzioni:

  • NOTSTARTEDYET
  • INPROGRESS
  • COMPLETED

Vai agli endpoint: