# Inizia con l'API di Instatus

Source: https://instatus.com/help/it/api

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](https://dashboard.instatus.com/developer)

```bash
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](https://instatus.com/help/page_id.png)

## Errori

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

```json
{
  "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](https://instatus.com/help/it/webhooks) 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:

- [Status page](https://instatus.com/help/it/api/status-pages)
- [Spazi di lavoro](https://instatus.com/help/it/api/workspaces)
- [Componenti](https://instatus.com/help/it/api/components)
- [Incidenti](https://instatus.com/help/it/api/incidents)
- [Aggiornamenti degli incidenti](https://instatus.com/help/it/api/incident-updates)
- [Manutenzioni](https://instatus.com/help/it/api/maintenances)
- [Aggiornamenti di manutenzione](https://instatus.com/help/it/api/maintenance-updates)
- [Modelli](https://instatus.com/help/it/api/templates)
- [Avvisi generali](https://instatus.com/help/it/api/generic-notices)
- [Disservizi](https://instatus.com/help/it/api/outages)
- [Membri del team](https://instatus.com/help/it/api/teammates)
- [Iscritti](https://instatus.com/help/it/api/subscribers)
- [Metriche](https://instatus.com/help/it/api/metrics)
- [Profilo utente](https://instatus.com/help/it/api/user-profile)
- [Dati pubblici](https://instatus.com/help/it/api/public-data)
- [Pagine private](https://instatus.com/help/it/api/private-pages)
- [Gruppi di pubblico](https://instatus.com/help/it/api/audience-groups)
- [Monitor](https://instatus.com/help/it/api/monitors)
- [Integrazioni di monitoraggio](https://instatus.com/help/it/api/monitoring-integrations)
- [Regole di instradamento](https://instatus.com/help/it/api/routing-rules)
- [Policy di escalation](https://instatus.com/help/it/api/escalation-policies)
- [Turni di reperibilità](https://instatus.com/help/it/api/on-call-schedules)