Guide curl

Pinger Verifagent avec curl

curl est le client portable le plus petit. Utilisez-le pour tester un monitor ou comme dernière étape de n’importe quel pipeline shell.

Avant de commencer

Créez un monitor avec la fréquence réelle de votre workflow, puis copiez son URL depuis le dashboard. Son token est secret : ne le publiez pas.

Module à utiliser : curl. Placez-le après la dernière action utile du chemin de succès.

Installation

Copiez l’URL du monitor

Collez l’URL de votre monitor ci-dessous. Le token est secret : traitez-le comme un mot de passe.

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

GET avec -fsS (recommandé)

-f échoue sur les erreurs HTTP, -s reste silencieux, -S affiche quand même les erreurs. Enchaînez après votre commande avec &&.

# Uniquement après une commande réussie
my-command && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

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

Variante POST

POST est accepté comme GET pour un heartbeat simple. Utile quand un outil n’autorise que POST.

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

# Corps JSON optionnel (stocké en métadonnées ; n’envoyez pas de secrets)
curl -fsS -X POST "https://verifagent.com/api/ping/your-ping-token" \
  -H "Content-Type: application/json" \
  -d '{"source":"shell"}'

Lisez la réponse

Un monitor sain renvoie HTTP 200 et {"ok":true}. Vérifiez ensuite le statut dans le dashboard.

{"ok":true}

Placez toujours curl après le succès. Pour un test ponctuel n’importe quelle période convient ; en production, alignez la période sur le vrai rythme et gardez une petite grâce.

Routes disponibles

L’URL de base suffit pour un heartbeat. Les variantes enrichissent l’historique si votre plateforme gère plusieurs branches.

GET https://VOTRE_URL_DE_PING

POST https://VOTRE_URL_DE_PING/success

POST https://VOTRE_URL_DE_PING/fail?msg=Erreur

Vérification

Lancez l’exemple GET, confirmez {"ok":true}, puis ouvrez le monitor : statut Up et horodatage du dernier signal à jour.

Réponse attendue : 200 {"ok":true}. Le monitor passe de Pending à Up.