Guía curl

Haz ping a Verifagent con curl

curl es el cliente portable más pequeño. Úsalo para probar un monitor o como paso final de cualquier pipeline shell.

Antes de empezar

Crea un monitor con la frecuencia real de tu workflow y copia su URL desde el panel. Su token es secreto: no lo publiques.

Módulo a usar : curl. Colócalo después de la última acción útil en la ruta de éxito.

Configuración

Copia la URL del monitor

Pega tu URL de monitor abajo. El token es secreto — trátalo como una contraseña.

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

GET con -fsS (recomendado)

-f falla con errores HTTP, -s permanece silencioso, -S sigue mostrando errores. Encadena después de tu comando con &&.

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

# Prueba independiente
curl -fsS "https://verifagent.com/api/ping/your-ping-token"

Variante POST

POST se acepta igual que GET para un heartbeat simple. Útil cuando una herramienta solo permite POST.

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

# Body JSON opcional (se guarda como metadatos — no envíes secretos)
curl -fsS -X POST "https://verifagent.com/api/ping/your-ping-token" \
  -H "Content-Type: application/json" \
  -d '{"source":"shell"}'

Lee la respuesta

Un monitor sano devuelve HTTP 200 y {"ok":true}. Luego revisa el estado en el panel.

{"ok":true}

Coloca siempre curl después del éxito. Para pruebas puntuales cualquier periodo vale; en producción, ajusta el periodo al calendario real y mantén un margen pequeño.

Rutas disponibles

La URL base basta para un heartbeat. Las variantes enriquecen el historial si tu plataforma tiene varias ramas.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

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

Verificar

Ejecuta el ejemplo GET, confirma {"ok":true} y abre el monitor — estado Up y una marca de última señal reciente.

Respuesta esperada: 200 {"ok":true}. El monitor pasa de Pending a Up.