curl-Anleitung

Verifagent mit curl pingen

curl ist der kleinste portable Client. Verwenden Sie ihn zum Testen eines Monitors oder als letzten Schritt jeder Shell-Pipeline.

Bevor Sie beginnen

Erstellen Sie einen Monitor mit der tatsächlichen Frequenz Ihres Workflows und kopieren Sie dann die URL aus dem Dashboard. Der Token ist geheim — veröffentlichen Sie ihn nicht.

Zu verwendendes Modul : curl. Platzieren Sie es nach der letzten sinnvollen Aktion auf dem Erfolgspfad.

Einrichtung

Monitor-URL kopieren

Fügen Sie Ihre Monitor-URL unten ein. Der Token ist geheim — behandeln Sie ihn wie ein Passwort.

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

GET mit -fsS (empfohlen)

-f scheitert bei HTTP-Fehlern, -s bleibt still, -S zeigt dennoch Fehler. Verketten Sie nach Ihrem Befehl mit &&.

# Nur nach erfolgreichem Befehl
my-command && curl -fsS "https://verifagent.com/api/ping/your-ping-token"

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

POST-Variante

POST wird wie GET für einen einfachen Heartbeat akzeptiert. Nützlich, wenn ein Tool nur POST erlaubt.

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

# Optionaler JSON-Body (als Metadaten gespeichert — keine Secrets senden)
curl -fsS -X POST "https://verifagent.com/api/ping/your-ping-token" \
  -H "Content-Type: application/json" \
  -d '{"source":"shell"}'

Antwort lesen

Ein gesunder Monitor liefert HTTP 200 und {"ok":true}. Prüfen Sie dann den Dashboard-Status.

{"ok":true}

Platzieren Sie curl immer nach Erfolg. Für Einzeltests funktioniert jede Periode; in Produktion passen Sie die Periode an den echten Zeitplan an und halten eine kleine Kulanz.

Verfügbare Routen

Die Basis-URL reicht für einen Heartbeat. Varianten bereichern den Verlauf, wenn Ihre Plattform mehrere Zweige hat.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

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

Prüfen

Führen Sie das GET-Beispiel aus, bestätigen Sie {"ok":true}, öffnen Sie den Monitor — Status Up und aktueller Zeitstempel des letzten Signals.

Erwartete Antwort: 200 {"ok":true}. Der Monitor wechselt von Pending zu Up.