Cliccare in una dashboard va bene per dieci monitor. Con cento servizi, decine di siti di clienti o un’infrastruttura che cambia ogni settimana, il monitoraggio deve vivere nel codice. La REST API copre monitor, finestre di manutenzione e aggiornamenti di stato, ed è documentata su app.uptimecheck.com/docs/api; un server MCP permette agli assistenti AI di fare lo stesso con una chiave API.
Endpoint
Tutti gli endpoint si trovano sotto https://app.uptimecheck.com/api/v1:
/monitors: elenca, crea, aggiorna ed elimina monitor di ogni tipo, mettili in pausa e riattivali, e leggi i loro controlli più recenti./monitors/{id}/metrics, /page-speed e /email: metriche dei server, risultati di Lighthouse e report di autenticazione email./incidents: elenca gli incidenti, leggi la timeline e prendine in carico uno./maintenance: pianifica, modifica, termina o annulla finestre di manutenzione, ed elenca, modifica o interrompi quelle ricorrenti sotto /maintenance-schedules. Una PATCH con i soli campi da modificare sposta una finestra, e gli iscritti che ne erano stati informati ricevono il nuovo orario./status-pages: elenca le tue pagine e pubblica, aggiorna ed elimina gli aggiornamenti di stato, con un impatto per ogni componente coinvolto./summary, /projects e /alert-channels: lo stato di tutto a colpo d’occhio e gli ID da usare quando crei i monitor.
Crea un monitor dalla tua pipeline
Autenticati con una chiave API nell’header Authorization e invia JSON:
curl https://app.uptimecheck.com/api/v1/monitors -H “Authorization: Bearer uc_…” -H “Content-Type: application/json” -d ‘{“type”:”http”,”name”:”Checkout”,”target”:”https://northwind.shop/checkout”,”intervalSeconds”:60}’
Eseguilo nello stesso step che effettua il deploy del servizio, e ogni nuovo endpoint è monitorato nel momento in cui va online. Il primo controllo parte entro un minuto. Il riferimento completo, con esempi di richieste e risposte, è nella documentazione dell’API.
Assistenti AI tramite MCP
Il server MCP su https://app.uptimecheck.com/api/mcp permette a Claude, Cursor, Copilot e ad altri assistenti di lavorare con il tuo monitoraggio usando le stesse chiavi API. Chiedi un riepilogo dello stato, analizza un incidente, testa una richiesta, crea un monitor, mettine uno in pausa durante il deploy, avvia una finestra di manutenzione o pubblica un aggiornamento di stato. Gli strumenti che modificano qualcosa richiedono una chiave di lettura e scrittura.
Usi comuni
Agenzie
Attiva un nuovo cliente con un solo script: aggiungi i monitor per il sito, il checkout e l’API nel progetto del cliente, con i canali di avviso giusti. Per chiudere il rapporto basta lo stesso script al contrario.
Team di piattaforma
Mantieni i monitor allineati al tuo catalogo dei servizi e avvia una finestra di manutenzione dallo script di deploy, così i riavvii pianificati non aprono incidenti e non pesano sull’uptime. Un provider Terraform per gestire i monitor come codice è in arrivo.
Comunicazione dello stato
Pubblica un aggiornamento di stato dai tuoi strumenti di gestione degli incidenti, così la pagina di stato e i suoi iscritti lo vengono a sapere nello stesso momento del tuo team.
Webhook per la direzione opposta
L’API ti permette di gestire Uptimecheck. I webhook permettono a Uptimecheck di chiamare te: ogni downtime e ogni ripristino viene inviato come JSON firmato al tuo endpoint, pronto da collegare a qualunque sistema gestisca la tua reperibilità. Vedi avvisi e notifiche.
Consigli pratici
Salva la chiave API come secret nel tuo sistema di CI, mai nel repository.Usa una chiave di sola lettura per dashboard e report, e una chiave di lettura e scrittura solo dove serve modificare qualcosa.Rendi gli script idempotenti: cerca un monitor per nome o target prima di crearlo, così una nuova esecuzione non crea duplicati.Usa nell’API la stessa convenzione di nomi della tua infrastruttura, così è facile risalire dal monitor al servizio che controlla.
La maggior parte dei team inizia automatizzando la parte noiosa, cioè aggiungere monitor per nuovi siti di clienti o nuovi servizi, e da lì passa alle finestre di manutenzione e agli aggiornamenti di stato.
L’accesso ad API e MCP è incluso nei piani Professional e Business. I piani partono da 9 € al mese con fatturazione annuale o 12 € con fatturazione mensile, IVA esclusa; confronta i piani nella pagina dei prezzi oppure inizia una prova gratuita di 14 giorni di Professional senza carta. Vedi il monitoraggio API per monitorare la tua API con Uptimecheck.