Monitoraggio API che scova la risposta sbagliata.

Il tuo endpoint di health check non vede un flusso di login interrotto. Uptimia accede, chiama l'API e verifica le risposte: ottieni il passo che ha fallito, non un ticket di assistenza.

Prova gratuita → Vedi i prezzi
Prova gratuita di 30 giorni · fino a 50 monitor API Senza carta di credito Pronto per il GDPR
Intervallo più rapido
60s
Località di conferma
3
Sonde
171+
Paesi con sonde
70+

La richiesta che è tornata sbagliata

Un flusso d'ordine a cinque passi, eseguito secondo pianificazione. Login, ricerca dell'ordine e totale passano tutti — la richiesta successiva no.

passo 1 Accedi — prendi il tokenIl login riesce; il token restituito finisce in {{token}} tu: indisturbato
passi 2-3 Chiama l'API con quel tokenGET /orders recupera {{order_id}}; l'ordine deve mostrare il totale corretto tu: indisturbato
passo 4 L'aggiunta della nota all'ordine fallisceL'asserzione indica il problema: la nota non è mai stata creata tu: indisturbato
14:32 Confermato altrove — poi vieni avvisatoAltre sonde rieseguono e confermano; l'avviso indica già il passo 4 avvisato: con la causa
passo 4indicato nell'avviso
"Il passo 4 ha fallito il controllo."14:32
Questa è l'intera indagine, già fatta prima ancora che tu apra il laptop: il passo, l'asserzione e la conferma che non sia solo una nottataccia di una sonda. La correzione parte dalla richiesta che ha fallito — non da "l'API è down".
passo che ha fallito, indicatoasserzione esatta citataconfermato da altre sondestato · tempistiche · header · valori — per passo
E con un semplice ping? /health continua a rispondere bene per tutto il tempo — un passo rotto in profondità nel flusso non lo tocca mai. La prima segnalazione arriva da un cliente che non è riuscito a completare l'operazione, seguita dalla caccia nei log per capire dove si è rotto tutto. scoperto da un cliente

Quello che un ping non vede mai

Una richiesta che riesce ma restituisce dati sbagliati resta comunque un fallimento, e un passo rotto a tre richieste di profondità non tocca mai il tuo endpoint di health check. Punta un monitor sulla tua API — o sulle API dei fornitori da cui dipendi, e scopri se il problema è loro, non tuo.

Codici di stato e headerLa risposta che ti aspetti, a ogni passo
Valori nella rispostaQualsiasi campo, controllato passo per passo
Fallimenti a metà flussoIl passo 3 fallisce — un ping non lo vede mai
Deriva della rispostaFormato sbagliato, campi mancanti
15 passi per catena l'intero flusso, eseguito per davvero
L'autenticazione si rompeToken scaduti, login rifiutati
Errori TLS e di connessioneHandshake e socket rifiutati
Budget del tempo di rispostaOgni passo entro il proprio limite
Gli avvisi indicano il passo e l'asserzione che hanno fallito: una richiesta fallita, un valore sbagliato nella risposta, un campo mancante, un passo lento, un errore di connessione o un login che ha smesso di funzionare. passo + asserzione

Catene, asserzioni e tempistiche

Il flusso

Concatena fino a 15 richieste

Ogni passo può estrarre un valore dalla risposta — un token, un id ordine — in una variabile che i passi successivi riutilizzano come {{name}}. Un solo monitor copre l'intero percorso, dal login alla pulizia finale.

  • 6 metodi HTTP — GET, POST, PUT, PATCH, DELETE o HEAD, in qualsiasi ordine
  • Estrai in variabili — richiamale ovunque nei passi successivi come {{name}}
  • Header, body e timeout personalizzati per ogni passo — duplica un passo per costruire in fretta
Guida un browser reale attraverso lo stesso flusso →
POST/auth/login1 asserzione
{{token}}estratto → passi successivi
GET/orders2 asserzioni
{{order_id}}
GET/orders/{{order_id}}3 asserzioni
POST/orders/{{order_id}}/notes1 asserzione
DEL/sessions/{{token}}pulizia
Catena superata1.94 s
Un solo monitor esegue l'intero percorso — dal login alla pulizia — anche ogni minuto.
5 passi7 asserzioni2 variabili
Un passo senza asserzioni passa comunque se la richiesta riesce — aggiungi controlli solo dove contano davvero. qualsiasi successo
Asserzioni

Verifica stato, valori e tempistiche

Aggiungi i controlli che un passo deve superare: uno stato esatto, un budget di tempo di risposta, un valore nel corpo della risposta, un header, o un testo nella risposta. Se uno fallisce, l'esecuzione mostra cosa ha ottenuto — e Esegui test raggiunge l'endpoint reale prima che tu salvi.

  • Stato e tempo di risposta — il passo fallisce se il codice è sbagliato o la risposta è troppo lenta
  • Valori dentro la risposta — indica un campo e richiedi che sia presente e corretto
  • Header della risposta e testo del body — richiedi il valore di un header, o un testo che deve essere presente o assente
Controlla il testo su una pagina, non solo lo stato →
Esegui test200 · 191 ms
GET /orders/8842 · passo 3 — la risposta live, raggiunta per davvero prima che tu salvi.
{
  "id": 8842,
  "status": "paid",
  "total": 4210
}
lo stato è 200ottenuto 200
$.status è uguale a "paid"ottenuto "paid"
tempo di risposta sotto i 500 msottenuto 191 ms
{{order_id}} estratto = 8842 alimenta il passo successivo — evidenziato nella risposta live qui sopra. = 8842
Tempistiche

DNS, TLS o il tuo backend

"L'API è lenta" non è mai tutta la storia. Il tempo di ogni passo è suddiviso in cinque fasi — DNS, connessione, TLS, attesa, ricezione — così vedi quale passo rallenta e se a trascinarlo è la rete o il tuo backend.

  • Tempistiche a cinque fasi per passo — DNS, connessione, TLS, attesa, ricezione
  • Grafico del tempo di risposta per passo — impilato, con indicatori degli incidenti
  • Passo più lento ed esecuzioni più lente in evidenza nella pagina di dettaglio del monitor
Tempistiche fase per fase per le pagine web →
Passo 4 — lento14:32:16
POST /orders/8842/notes · 1.389 ms totali, suddivisi in cinque fasi.
dns18 ms
connessione31 ms
tls44 ms
attesa1,284 ms
ricezione12 ms
Rete — ok
dns 18 · connect 31 · tls 44
93 ms
Backend — il collo di bottiglia
tempo di elaborazione prima del primo byte
1,284 ms
Passo più lento ed esecuzioni più lente si trovano nella pagina del monitor — un grafico impilato per passo mostra quando è iniziato il rallentamento. il più lento
Segreti

Chiavi API reali, sempre mascherate

Salva password, chiavi API e token come variabili segrete: scrivibili ma non leggibili, mascherate in lettura e oscurate negli URL, header e frammenti di risposta mostrati in log. Niente di sensibile finisce nella cronologia delle esecuzioni.

  • Variabili segrete di sola scrittura — mascherate ogni volta che vengono rilette
  • Oscurate ovunque vengano ripetute — URL, header e frammenti del body
  • Anche i valori estratti che corrispondono a un segreto non vengono mai mostrati
Monitora pagine protette da login →
API_KEYsegreto
••••••••••••••••sola scrittura
Salvato una volta, mai più mostrato — una lettura restituisce value:'' · has_value:true.
Header del passo 1 — cosa configuri
Authorization: Bearer {{API_KEY}}
chiave reale iniettata al momento dell'invio — solo in memoria, mai salvata
Cronologia delle esecuzioni — cosa viene salvato
Authorization: Bearer [redacted]
Anche i valori estratti che corrispondono a un segreto non vengono mai mostrati — niente di sensibile finisce nella cronologia delle esecuzioni. mascherato

Concatena le richieste una sola volta.Scopri subito qual è il passo che ha fallito.

Ogni passo, ogni asserzione, ogni canale di avviso — gratis per 30 giorni, e nessuno di questi è un componente aggiuntivo a pagamento.

Inizia la tua prova gratuita di 30 giorni →
30 giorni gratis senza carta di credito annulla quando vuoi

Come funziona il monitoraggio API

Costruisci la catena, mettila alla prova sull'API live, poi Uptimia la esegue secondo pianificazione dalla nostra rete — niente da installare.

Passo 1costruiscila

Concatena le tue richieste

Aggiungi ogni richiesta in ordine, imposta header e body, ed estrai in variabili i valori di cui i passi successivi hanno bisogno.

Passo 1 · richiesta
POST /auth/login
estrai $.token → {{token}}
Passo 2 · richiesta
GET /orders
Passo 2mettila alla prova

Verifica ed esegui un test

Aggiungi i controlli che ogni passo deve superare, poi lancia Esegui test contro l'endpoint reale — risultati completi per passo, prima di salvare.

Asserzioni · passo 3
lo stato è 200$.status = "paid"
sotto i 500 ms
Esegui test · 5/5 passi superati in 1,9 s
Passo 3ogni minuto

La eseguiamo secondo pianificazione

Una sonda esegue l'intera catena in un solo round trip, controlla ogni asserzione e salva i risultati per ogni passo — i fallimenti vengono confermati da altre sonde prima di avvisarti.

Esecuzione OK — 5/5 passi
14:31 · 1,8 s · tutte le asserzioni superate
in orario
Esecuzione fallita — passo 4
14:32 · atteso 201, ottenuto 500
avviso in corso

Incluso anche

Slack, PagerDuty, SMS e altri 9

Un avviso API indica il passo che ha fallito e la causa, recapitato sugli stessi contatti usati da ogni monitor Uptimia — email, SMS, Slack, Teams, Discord, PagerDuty, webhook e altro ancora.

passo 3 · $.status: atteso "paid", ottenuto "pending" → Slack · Email · PagerDuty

Confermato da altre sonde prima di avvisarti

Un'esecuzione fallita viene prima ritentata da altre sonde in grado di eseguirla.

rieseguito altrove · confermato prima dell'apertura

Duplica un passo

Costruisci una lunga catena in fretta — copia una richiesta e modificala.

passo 3 → duplica → passo 4

Esportazione RCA dell'incidente

Un incidente chiuso conserva il dettaglio a livello di passo — esportalo.

RCAPDFHTML

Timeout, header e body per ogni richiesta

Assegna a ogni richiesta il proprio timeout, header e body.

timeout 10 s · 20 header · body 64 KB

Ogni tipo di Monitor in un solo account

I tuoi monitor API stanno accanto ai monitor uptime, SSL, heartbeat e DNS — stessi contatti, gruppi e ruoli.

Checkout order flowAPI www.caldmont.comUPTIME db-backup · nightlyHEARTBEAT

Cos'è il monitoraggio API?

Il monitoraggio API è un servizio automatico che esegue secondo pianificazione una vera sequenza di richieste HTTP contro la tua API REST o il tuo endpoint JSON e ti avvisa quando un passo restituisce lo stato sbagliato, i dati sbagliati o impiega troppo tempo. Osserva il flusso dietro un endpoint, non solo se il server ha risposto.

Mentre tutto funziona

Come funziona il monitoraggio API?

Uptimia
esegue la catena
5 passi · secondo pianificazione
La tua API
ogni controllo passa

Una sonda esegue ogni passo in un solo round trip, valuta ogni asserzione e salva i risultati per passo come cronologia delle esecuzioni.

Quando un controllo fallisce

Prima conferma, poi avvisa

La tua API
passo 4 · fallito
rieseguito · altre sonde
Uptimia
apre l'incidente

il passo 4 ha fallito il controllo → l'incidente si apre, l'avviso indica il passo

I controlli

Cosa verifica un monitor API?

Per impostazione predefinita un passo passa se la risposta ha successo. Aggiungi asserzioni e l'esecuzione dovrà dimostrarle — uno stato esatto, un budget di tempo di risposta, un valore nella risposta, un header o un testo nel body.

Strumento gratuito: verifica stato e header di qualsiasi endpoint →
ControlloCosa dimostraEsempio
Codice di statol'endpoint ha risposto come previstoè 201 · è uno tra 200/204 · qualsiasi 2xx
Tempo di rispostail passo è abbastanza velocesotto i 500 ms
Body JSONla risposta contiene i dati corretti$.status è uguale a "paid"
Headeril tipo di contenuto o la regola di cache correttiContent-Type contiene json
Testo del bodyun marcatore è presente o assentecontiene "order created"

Domande frequenti sul monitoraggio API

01Cos'è il monitoraggio API?+
Un servizio automatico che esegue secondo pianificazione una vera sequenza di richieste HTTP contro la tua API e controlla le risposte. Un monitor Uptimia concatena fino a 15 richieste e ti avvisa quando un passo restituisce lo stato sbagliato, i dati sbagliati o impiega troppo tempo. Lo troverai chiamato anche monitoraggio API sintetico o health check API automatico.
02In cosa si differenzia da un semplice ping di uptime?+
Un ping ti dice solo che il server ha risposto. Il monitoraggio API esegue l'intero flusso e controlla la risposta stessa — codice di stato, tempo di risposta, header e i valori nel JSON. Un 200 che restituisce dati sbagliati viene individuato qui, ma resta invisibile a un semplice ping.
03Con quale frequenza Uptimia esegue il mio controllo API?+
Per impostazione predefinita ogni 5 minuti, e fino a una volta al minuto — la scansione di pianificazione gira ogni minuto, quindi un minuto è il limite minimo. Puoi anche rallentare qualsiasi monitor per gli endpoint a priorità più bassa.
04Quanti passi può avere un monitor?+
Fino a 15 richieste HTTP in un'unica catena, ciascuna con fino a 20 header, 15 asserzioni e 10 estrazioni di valori. Il timeout per passo va da 1 a 60 secondi, e l'intera catena ha un budget di esecuzione di 90 secondi.
05Esegue JavaScript o renderizza la pagina come un browser?+
No. Il monitoraggio API invia semplici richieste HTTP — nessun browser headless, nessun JavaScript, nessuno screenshot. Per guidare un browser reale attraverso un flusso renderizzato, usa il monitoraggio delle transazioni di Uptimia; il monitoraggio API è lo strumento più snello e veloce per l'API in sé.
06Posso controllare un valore dentro la risposta JSON?+
Sì. Punta un selettore JSONPath sul campo e verifica che esista, che sia uguale, che contenga o che sia uno tra un insieme di valori. Puoi anche estrarre un valore in una variabile e riutilizzarlo nei passi successivi come {{name}}. Il supporto JSONPath è un sottoinsieme mirato, pensato per le tipiche risposte API.
07Supportate GraphQL o i WebSocket?+
GraphQL funziona come una normale POST HTTP — invii la query nel body e verifichi il JSON che torna indietro — ma non esiste un builder specifico per GraphQL. I WebSocket non sono supportati; il monitoraggio API copre richiesta/risposta via HTTP (GET, POST, PUT, PATCH, DELETE, HEAD).
08Posso importare un comando cURL o partire da un modello già pronto?+
Non in questa versione. Costruisci ogni passo nell'editor — metodo, URL, header, body, asserzioni, estrazioni — e puoi duplicare un passo per andare veloce. L'importazione da cURL e una libreria di modelli non fanno ancora parte del monitoraggio API.
09Come evitate i falsi allarmi?+
Un'esecuzione fallita viene rieseguita da altre sonde prima che si apra un incidente — per impostazione predefinita servono tre sonde concordi (l'originale più due riesecuzioni) prima che tu venga avvisato. Il recupero è invece rapido: basta una sola esecuzione riuscita per chiudere l'incidente e inviare la notifica di ripristino.
10Le mie chiavi API sono al sicuro dentro un controllo?+
Sì. Salva le credenziali come variabili segrete: scrivibili ma non leggibili, mascherate in lettura e oscurate negli URL, header e frammenti di risposta mostrati in log — niente di sensibile finisce nella cronologia delle esecuzioni.
11Il monitoraggio API è un componente a pagamento?+
No. Ogni piano include il monitoraggio API insieme a uptime, SSL, transazioni, DNS ed heartbeat — mai come componente aggiuntivo a pagamento. Anche il piano gratuito include un monitor API; i piani differiscono solo per quanti ne includono, e la prova gratuita di 30 giorni ne include fino a 50, senza carta di credito.

Inizia a monitorare la tua API oggi stesso.

Costruisci la catena, mettila alla prova sull'endpoint live — e la prossima volta che un passo si rompe, l'avviso ti dirà già quale.

Prova gratuita →
Prova gratuita di 30 giorni Fino a 50 monitor API Senza carta di credito Pronto per il GDPR
Il monitoraggio API si affianca a uptime, SSL, velocità, transazioni, DNS ed heartbeat sotto un unico login Uptimia.