# Documentazione API di UptimeScout

Stato dei servizi, indicatori regionali e cronologia tramite REST, SDK e MCP. Crea dashboard e fornisci agli assistenti IA un quadro chiaro della disponibilità.

URL: https://uptimescout.com/it/docs/

## REST

```sh
curl -G https://api.uptimescout.com/v1/status --data-urlencode "service=github" --data-urlencode "region=US" -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
```

## Metodi disponibili

- `GET /v1/services`: Cerca nel catalogo dei servizi e sfoglialo per pagine.

- `GET /v1/status`: Consulta lo stato salvato più recente di un servizio.

- `GET /v1/statuses`: Consulta lo stato di più servizi con un'unica richiesta.

- `GET /v1/summary`: Riassume i segnali osservati per una regione o per i servizi selezionati.

- `GET /v1/history`: Consulta le osservazioni salvate nel tempo, con paginazione.

- `GET /v1/stats`: Calcola i rapporti tra i campioni dei segnali salvati, non la disponibilità misurata.

- `GET /v1/incidents`: Elenca i servizi con segnali di anomalia; non si tratta di incidenti globali confermati.

## Come funzionano i dati

UptimeScout memorizza in background le osservazioni regionali. Ogni risposta include l’ora dell’osservazione e le informazioni sulla sua attualità. Lo stesso servizio può mostrare segnali diversi in regioni diverse.

Un segnale operativo indica che nel campione salvato non sono state osservate anomalie rilevanti. I segnali di anomalia o disservizio descrivono condizioni osservate, non un incidente globale confermato. Le osservazioni mancanti o obsolete sono considerate sconosciute. I rapporti tra i campioni non corrispondono a percentuali di disponibilità misurate né a un SLA.

L’interfaccia si aggiorna ogni minuto. Controlla l’ora di rilevazione e l’indicatore di aggiornamento di ciascun servizio per valutare quanto siano recenti i dati sullo stato.

La lingua determina come vengono presentate le informazioni; la regione di osservazione determina il paese a cui si riferiscono i dati. Puoi modificarle indipendentemente. Una pagina tradotta non implica automaticamente che le osservazioni provengano da un determinato paese.

## Licenza e limiti delle richieste

Usa la chiave di licenza Evelode come token Bearer. Conservala sul server, fuori dal codice del browser e dai repository pubblici. Solo le richieste di dati autorizzate e completate correttamente consumano la quota. Il rinnovo della licenza o la modifica del piano avvia una nuova quota; il cambio di mese non la azzera. I piani annuali offrono una quota unica pari a dodici volte quella del piano mensile, valida per l’intero periodo annuale della licenza.

## Collega un assistente AI

Collega un client MCP HTTP Streamable all’endpoint qui sotto e inserisci la chiave di licenza nell’header Authorization. Sette strumenti di sola lettura forniscono stati dei servizi, indicatori regionali e cronologia. Si applicano gli stessi limiti della licenza.

https://mcp.uptimescout.com

## Gestione delle risposte

Controlla lo stato HTTP prima di leggere i dati: 400 indica parametri non validi, 401 o 403 un problema di autenticazione o di licenza, 409 una modifica dei diritti associati alla licenza durante la richiesta, 429 il superamento di un limite di richieste o di frequenza e 503 un'indisponibilità temporanea. Rispetta i tempi di attesa prima di riprovare ed evita tentativi ripetuti a intervalli troppo ravvicinati.

OpenAPI: https://uptimescout.com/openapi.json
