uptimescout
Ottieni una chiave di licenza

REST / MCP / SDK

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à.

Guida rapida

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/servicesCerca nel catalogo dei servizi e sfoglialo per pagine.
GET /v1/statusConsulta lo stato salvato più recente di un servizio.
GET /v1/statusesConsulta lo stato di più servizi con un'unica richiesta.
GET /v1/summaryRiassume i segnali osservati per una regione o per i servizi selezionati.
GET /v1/historyConsulta le osservazioni salvate nel tempo, con paginazione.
GET /v1/statsCalcola i rapporti tra i campioni dei segnali salvati, non la disponibilità misurata.
GET /v1/incidentsElenca 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.

Tutti i servizi

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.

Pagamenti, rinnovi, modifiche del piano e gestione delle licenze sono gestiti da Evelode.com. La quota di richieste si azzera al rinnovo della licenza o quando si cambia piano, non all’inizio di un mese di calendario. I piani annuali riuniscono in un’unica quota dodici quote mensili di richieste per l’intera durata della licenza. La cronologia si accumula dall’avvio della raccolta. Il piano Free non prevede addebiti ricorrenti.

Prezzi

Collega un assistente AI

Aggiungi l’URL del server nel tuo assistente, scegli OAuth e accedi con Evelode oppure inserisci la chiave di licenza nella schermata di collegamento. Non serve un segreto client.

Collega UptimeScout

https://mcp.uptimescout.com
Authorization: Bearer YOUR_EVELODE_LICENSE_KEY

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.

Esempio basato su osservazioni salvate

{
  "available_regions": [
    "AE",
    "AR",
    "AT",
    "AU",
    "AZ",
    "BD",
    "BE",
    "BG",
    "BH",
    "BR",
    "CA",
    "CH",
    "CL",
    "CO",
    "CR",
    "CZ",
    "DE",
    "DK",
    "DO",
    "DZ",
    "EC",
    "EG",
    "ES",
    "FI",
    "FR",
    "GB",
    "GR",
    "GT",
    "HK",
    "HR",
    "HU",
    "ID",
    "IE",
    "IL",
    "IN",
    "IT",
    "JO",
    "JP",
    "KE",
    "KR",
    "MA",
    "MX",
    "MY",
    "NG",
    "NL",
    "NO",
    "NZ",
    "PA",
    "PE",
    "PH",
    "PK",
    "PL",
    "PR",
    "PT",
    "PY",
    "RO",
    "RS",
    "RU",
    "SA",
    "SE",
    "SG",
    "SK",
    "TH",
    "TN",
    "TR",
    "TW",
    "UA",
    "US",
    "UY",
    "VE",
    "VN",
    "ZA"
  ],
  "data_type": "availability_observations",
  "generated_at": "2026-11-18T18:55:14.484329Z",
  "region": "US",
  "service": {
    "age_seconds": 12,
    "category": "it",
    "description": "Piattaforma per repository Git, collaborazione sul codice, issue e distribuzione del software.",
    "description_language": "it",
    "id": "github",
    "logo_kind": "brand",
    "logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
    "name": "GitHub",
    "observed_at": "2026-11-18T18:55:01.987427Z",
    "regions": [
      "US"
    ],
    "scope": "regional",
    "signal": "reported_availability",
    "stale": false,
    "status": "outage"
  },
  "stale_after_seconds": 600,
  "status": "ok"
}

Vista rapida

Caricamento delle osservazioni salvate

Segnali nel tempo

Ogni intervallo mostra il segnale osservato più frequente. In caso di parità, prevale lo stato osservato più di recente tra quelli a pari merito. Seleziona una colonna per visualizzare la ripartizione completa.