Übersicht über die API-Referenz
Mit der DiffHook-REST-API können Sie Monitore programmgesteuert erstellen und verwalten sowie Zustellungsprotokolle abfragen.
Basis-URL
https://www.diffhook.com
Authentifizierung
Für alle Anfragen ist ein Inhabertoken erforderlich:
Authorization: Bearer JWTXYZ
Inhaltstyp
Schließen Sie bei POST- und PUT-Anfragen immer Content-Type: application/json ein.
Ressourcentypen
Monitore – Die Kernressource. Ein Monitor stellt eine überwachte URL zusammen mit ihrer Konfiguration (Intervall, Ziel, Selektor) dar.
Protokolle – Unveränderliche Aufzeichnungen von Webhook-Zustellungen. Wird automatisch erstellt, wenn eine Änderung festgestellt wird.
Zeitstempel
Alle Zeitstempel sind im ISO 8601-Format in UTC:
2026-03-16T14:22:00Z
Pagination
Listenendpunkte geben standardmäßig bis zu 50 Elemente zurück. Verwenden Sie den Abfrageparameter limit, um bis zu 200 anzufordern.
HTTP-Statuscodes
| Code | Bedeutung |
|---|---|
| 200 | OK |
| 201 | Erstellt |
| 204 | Kein Inhalt (erfolgreiches Löschen) |
| 400 | Ungültige Anfrage – Anfragetext prüfen |
| 401 | Nicht autorisiert – API-Schlüssel prüfen |
| 403 | Verboten – Limit erreicht |
| 404 | Nicht gefunden |
| 429 | Rate begrenzt – langsamer |
| 500 | Serverfehler – Support kontaktieren |