Guida curl

Pinga Verifagent con curl

curl è il client portatile più piccolo. Usalo per testare un monitor o come passaggio finale di qualsiasi pipeline shell.

Prima di iniziare

Crea un monitor con la frequenza reale del workflow, poi copia l'URL dalla dashboard. Il token è segreto: non pubblicarlo.

Modulo da usare : curl. Posizionalo dopo l'ultima azione utile sul percorso di successo.

Configurazione

Copia l'URL del monitor

Incolla l'URL del monitor qui sotto. Il token è segreto — trattalo come una password.

https://verifagent.com/api/ping/your-ping-token

GET con -fsS (consigliato)

-f fallisce su errori HTTP, -s resta silenzioso, -S mostra comunque gli errori. Concatena dopo il comando con &&.

# Solo dopo un comando riuscito
my-command && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

# Test standalone
curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Variante POST

POST è accettato come GET per un heartbeat semplice. Utile quando uno strumento consente solo POST.

curl -fsS -X POST "https://verifagent.com/api/ping/your-ping-token"

# Body JSON opzionale (salvato come metadati — non inviare secret)
curl -fsS -X POST "https://verifagent.com/api/ping/your-ping-token" \
  -H "Content-Type: application/json" \
  -d '{"source":"shell"}'

Leggi la risposta

Un monitor sano restituisce HTTP 200 e {"ok":true}. Poi controlla lo stato nella dashboard.

{"ok":true}

Posiziona sempre curl dopo il successo. Per test una tantum va bene qualsiasi periodo; in produzione, allinea il periodo alla pianificazione reale e mantieni una piccola tolleranza.

Route disponibili

L'URL base basta per un heartbeat. Le varianti arricchiscono la cronologia se la piattaforma ha più rami.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

Verifica

Esegui l'esempio GET, conferma {"ok":true}, poi apri il monitor — stato Up e timestamp dell'ultimo segnale aggiornato.

Risposta attesa: 200 {"ok":true}. Il monitor passa da In attesa a Up.