Webhooks

Webhooks legen Sie im Dashboard an. Jeder Webhook hat eine Trigger-URL. Ein Aufruf dieser URL löst den Vorgang aus (typisch einen Bucket-Snapshot).

Wichtig: Webhooks sind nicht für die S3-API (Kopia, AWS CLI, rclone, Proxmox). Dafür gelten S3-Zugangsdaten.

Webhook anlegen

Bucket im Dashboard auswählen
Tab Webhooks öffnen
Optionalen Kommentar eingeben (z. B. „Snapshot vom NAS“)
Webhook erstellen

Die Trigger-URL wird nur einmal vollständig angezeigt. Speichern Sie sie sicher. In der Tabelle sehen Sie danach nur ein Präfix zur Wiedererkennung, letzte Nutzung, die letzte IP und einen QR-Code der URL. Die volle URL können Sie über das Zeilenmenü erneut kopieren.

Trigger-URL

Die URL hängt an der Region des Buckets – nicht am gemeinsamen S3-Host s3.bunker1.internett.de:

https://{region}.bunker1.internett.de/api/v1/webhook/{webhook}

Beispiel für Region eu-central-1:

https://eu-central-1.bunker1.internett.de/api/v1/webhook/…

{webhook} ist das Token aus dem Dashboard.

Aufruf

Ersetzen Sie REGION durch die Region des Buckets und WEBHOOK durch das Token aus dem Dashboard.

export REGION="eu-central-1"
export WEBHOOK="ihr-webhook-token"
export URL="https://${REGION}.bunker1.internett.de/api/v1/webhook/${WEBHOOK}"

POST

Setzt einen Snapshot. Daten im Body erscheinen zusammengefasst als Kommentar zum Snapshot. Alternativ setzt der URL-Parameter ?comment= einen Kommentar.

curl -X POST \
  --data '...' \
  "$URL"

GET

Ohne Parameter wird die Gültigkeit des Webhooks überprüft.
?list listet alle Snapshots im JSON-Format auf. ?list=text erzeugt dieselbe Liste als Plaintext.
?comment= setzt einen Snapshot mit dem Kommentar hinter dem Gleichheitszeichen.

curl "$URL"
curl "$URL?list"
curl "$URL?list=text"
curl "$URL?comment=Backup"

Sicherheit

Die Trigger-URL wie ein Passwort behandeln.
Nicht in öffentliche Repositories, Tickets oder Chat-Verläufe kopieren.
Wird die URL bekannt, den Webhook löschen und einen neuen anlegen.

Haben Sie Fragen? Kontaktieren Sie uns über kontakt@internett.de.