Integrationen

Um an Honk zu senden, reicht eine Webanfrage an einen Endpunkt: POST /v1/messages. Das schafft ein Shell-Skript, ein Workflow-Tool oder ein paar Zeilen in deiner App. Für deinen eigenen Code bringen die offiziellen Bibliotheken Retries, einen Idempotency-Key bei jedem Senden und Helfer für die Honk-Skala mit. Alle stehen unter MIT-Lizenz und liegen auf GitHub.

Einen Dienst mit einer URL verbinden

Stripe, Shopify, GitHub, Sentry, Grafana, Prometheus Alertmanager und Uptime Kuma können selbst an Honk senden. Öffne in der Web-App die Verbindungen eines Projekts, wähle den Dienst und füge die URL von Honk in seine Webhook-Einstellungen ein. Honk prüft die Signatur und gibt jedem Ereignis seine Stufe. Free enthält 2 Verbindungen pro Workspace, Pro 20 und Team 100.

Ohne eigenen Code

Diese Tools senden an Honk, ohne dass du Code schreibst. Für WordPress gibt es das offizielle Plugin Honk Me, das gerade für das WordPress-Plugin-Verzeichnis geprüft wird. Für alle anderen zeigt jede Anleitung eine Einrichtung, die heute schon funktioniert.

Bibliotheken und Tools

Ohne Bibliothek

Eine HTTPS-Anfrage genügt. Das hier ist schon die ganze API zum Senden:

Terminal
curl -sS https://honk-honk.app/v1/messages \
  -H "Authorization: Bearer $HONK_KEY" \
  -H "Idempotency-Key: backup-$(date +%Y%m%d)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Backup failed",
    "message": "pg_dump exited with 1",
    "severity": "long",
    "group_key": "db/backup",
    "event_type": "problem"
  }'
# → 202 {"id":"msg_…","status":"accepted","duplicate":false,"received_at":"…"}

Die Web-App schreibt den Code für dich

In der Web-App erzeugt Integrationen fertigen Code für dein Projekt in jeder dieser Sprachen und legt auf Wunsch gleich einen passenden Ingest-Schlüssel an.

Anleitungen Schritt für Schritt