uptimescout
Ottieni una chiave di licenza

Guida UptimeScout

Come integrare un’API di disponibilità dei servizi con UptimeScout

Crea un pannello di disponibilità che mantenga visibili timestamp e incertezza, invece di ridurre ogni risposta a un punto colorato.

Connettori ottici e di rete su un pannello server.
Illustrazione editoriale generata con IA

Individua gli ID dei servizi prima di interrogarli periodicamente

Inizia dall’endpoint dei servizi per trovare l’identificatore usato da UptimeScout. Un nome di marchio leggibile dagli utenti non corrisponde sempre all’identificatore API. Mantieni ID e regione nella configurazione dell’applicazione, così le richieste di stato e cronologia si riferiranno allo stesso elemento.

Acquista una licenza idonea tramite Evelode e conservala in un segreto lato server o in una variabile d’ambiente. Non inserire una chiave di licenza in JavaScript lato browser, in un repository pubblico, in uno screenshot o in un URL.

Invia una richiesta di stato autenticata

Imposta EVELODE_LICENSE_KEY nel tuo ambiente prima di eseguire l’esempio. L’esempio richiede le osservazioni US per GitHub: è un modello di richiesta, non un’affermazione sullo stato attuale di GitHub.

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

Interpreta la risposta prima di mostrarla

La risposta positiva del trasporto e il segnale di disponibilità del servizio sono livelli distinti. Per prima cosa convalida lo stato HTTP e l’involucro della risposta. Poi controlla service.status, service.observed_at e service.stale. Mantieni visibili unknown e stale, invece di considerarli implicitamente operational.

Salva la regione insieme all’ora dell’osservazione. Se la tua interfaccia si aggiorna ogni minuto, mostra separatamente l’ora dell’osservazione e quella in cui la tua applicazione ha recuperato la risposta. Una risposta HTTP recente può descrivere un’osservazione più vecchia.

Pianifica il volume di richieste e gestisci i limiti

Se il tuo flusso di lavoro lo consente, usa le richieste di stato in batch e verifica la dimensione massima del batch prevista dal piano selezionato. Il pacchetto di richieste e il limite di richieste al minuto sono distinti. L’accesso tramite REST, SDK e MCP condivide lo stesso conteggio associato alla licenza.

In caso di HTTP 429, rispetta Retry-After ed evita una raffica di tentativi immediati. Per gli errori temporanei, usa tentativi limitati con ritardi crescenti; non ripetere all’infinito le richieste con errori di autenticazione o parametri non validi. I rinnovi e le modifiche del piano aggiornano il pacchetto della licenza; non è previsto un rinnovo il primo giorno del mese di calendario.

Verifica i casi incerti prima del rilascio

Prova un servizio noto, un ID sconosciuto, una chiave mancante, parametri non validi e un’osservazione obsoleta o mancante. Verifica che questi casi producano messaggi utili nell’interfaccia. Non includere nei log pubblici i risultati diagnostici completi se contengono credenziali o informazioni sull’account.

La documentazione API include tutti e sette i metodi pubblici e lo schema OpenAPI. jsonscraper rimanda agli SDK per Python, Node.js, PHP, Go, Java e .NET. Una libreria client semplifica il trasporto, ma l’applicazione deve comunque definire come interpretare l’incertezza.

Contenuti revisionati il 18 novembre 2026.

Markdown

REST / MCP / SDK

Controlla un servizio o integra l’API

Consulta la directory dei servizi per un segnale regionale aggiornato e la documentazione per un’integrazione riproducibile.

Directory dei serviziDocumentazione API