API

Pingio REST-API

Alles, was das Dashboard kann, ist über HTTPS verfügbar – so lebt Ihr Monitoring im selben Repository wie Ihre Infrastruktur.

Basis-URL und Versionierung

Alle Endpunkte liegen unter einem versionierten Präfix. Breaking Changes erscheinen als neue Version; ergänzende Änderungen erfolgen an Ort und Stelle.

https://pingio.io/api/v1

Authentifizierung

Anfragen werden mit einem Bearer-Token für Ihr Team authentifiziert. Halten Sie das Token serverseitig und tauschen Sie es aus, falls es je offengelegt wird.

curl https://pingio.io/api/v1/monitors \
  -H "Authorization: Bearer $PINGIO_TOKEN"

Einen Monitor anlegen

Senden Sie einen JSON-Body mit dem Ziel und den Prüfregeln. Die Antwort enthält den erstellten Monitor samt der Kennung, die Sie für spätere Anfragen verwenden.

curl -X POST https://pingio.io/api/v1/monitors \
  -H "Authorization: Bearer $PINGIO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API",
    "type": "http",
    "target": "https://api.example.com/health",
    "intervalSeconds": 60
  }'

Ratenbegrenzung und Fehler

Die API erlaubt eine großzügige Anfragerate je Team und gibt standardisierte HTTP-Statuscodes zurück. Fehler enthalten einen maschinenlesbaren Code und eine verständliche Meldung.

Eine 429-Antwort enthält einen Retry-After-Header. Werten Sie ihn als Signal, zurückzufahren, statt sofort erneut anzufragen.