Un’API può essere online e comunque non funzionare. Il load balancer risponde, lo status code è 200 e il body dice che la connessione al database è fallita. La tua app mobile, i tuoi partner e il tuo frontend vedono tutti un errore, mentre un semplice controllo di uptime non nota nulla di strano.
Il monitoraggio API chiama i tuoi endpoint a intervalli regolari e verifica sia che rispondano sia che la risposta sia corretta. In Uptimecheck usa gli stessi monitor HTTP(S) del monitoraggio uptime dei siti web, con le opzioni di cui un’API ha bisogno.
Cosa puoi configurare
Metodo: GET, POST, PUT, PATCH, DELETE, HEAD o OPTIONS.Header: fino a 20, ad esempio una API key, un header Authorization o uno user agent personalizzato.Body: invia un payload JSON per testare un percorso di scrittura.Status atteso: codici o intervalli, come 200-299 o 201.Controlli su JSON e header: fino a 10 controlli che devono essere tutti soddisfatti, ad esempio $.status uguale a ok.Parola chiave: testo che la risposta deve o non deve contenere.Timeout e soglia di lentezza: errore dopo un massimo di 30 secondi e un avviso di lentezza quando le risposte restano sopra la tua soglia.
Quali endpoint monitorare per primi
Parti dalle richieste che portano fatturato o che bloccano gli utenti. Per un e-commerce sono il carrello, il checkout e la callback di pagamento. Per un prodotto SaaS sono il login, l’endpoint di lettura principale e ogni webhook che ricevi da un provider di pagamento. La checklist per il monitoraggio API elenca cosa coprire e con quale frequenza, e la nostra guida agli endpoint di health check mostra cosa dovrebbe restituire un buon endpoint.
Una configurazione tipica per lumenanalytics.io
GET /health ogni minuto, con un controllo JSON che $.status sia uguale a ok.POST /v1/events con un piccolo payload di test e un header con la API key.GET /v1/reports con un header Authorization e un avviso di lentezza a 1.500 ms.
Scopri quando un endpoint rallenta
Uptimecheck esegue i controlli da Stoccolma, Londra e New York e conferma ogni errore da una seconda località prima di aprire un incidente, così una singola richiesta persa non sveglia tutto il team. I tempi di risposta vengono salvati per ogni controllo e suddivisi in DNS, connessione, TLS, server e download: puoi vedere che l’endpoint dei report è passato da 90 ms a 2,4 s alle 14:00, che il tempo in più è andato nella fase server e che l’health check è rimasto stabile.
Quando una richiesta non basta
Molti problemi delle API emergono solo in sequenza: login, ottenimento di un token, uso del token. Un monitor di flusso esegue fino a 10 passaggi in ordine, salva un valore come un token o un ID ordine da un passaggio e lo usa in quello successivo. I segreti come le password vengono cifrati e non vengono mai più mostrati.
Avvisi e automazione
Quando un endpoint fallisce, gli avvisi arrivano via email, Slack, Microsoft Teams, Discord, Google Chat, Mattermost, Telegram, PagerDuty, ntfy, Pushover, webhook e notifiche push sul telefono, su ogni piano. I webhook sono firmati, così i tuoi strumenti possono verificarne la provenienza. Puoi anche gestire i monitor da codice: su Professional e Business, la REST API crea e aggiorna i monitor dalla tua pipeline di deploy, così un nuovo endpoint ha il suo monitor dal giorno del rilascio.
Monitora le dipendenze, non solo il tuo codice
La tua API dipende da altri: un provider di pagamento, un servizio email, una piattaforma di hosting. Quando uno di questi si guasta, il tuo endpoint può continuare a rispondere mentre la funzionalità che c’è dietro non funziona. Aggiungi monitor per gli endpoint che li coinvolgono e segui le pagine di stato di fornitori come Klarna, Shopify, Cloudflare e OpenAI con il monitoraggio dei servizi di terze parti. Così puoi dire a un cliente in pochi minuti se il problema è tuo o a monte.
Mantieni sicuro il traffico di test
Usa un account di test o una API key dedicati per le richieste di monitoraggio e rendi idempotenti i controlli di scrittura, così un POST ogni minuto non riempie il database di record di test. Contrassegna il traffico di monitoraggio con un header user agent personalizzato, così è facile escluderlo dalle tue analytics e dai log.
Per i processi in background che non espongono un endpoint, usa invece il monitoraggio dei cron job.
I piani partono da 9 € al mese con fatturazione annuale o 12 € con fatturazione mensile, IVA esclusa. Consulta tutti i limiti nella pagina prezzi oppure inizia una prova gratuita di 14 giorni senza carta.