Webhook konfigurieren

Richten Sie Timemark auf Ihren Endpunkt aus, wählen Sie aus, welche Ereignisse und welche Projekte ihn auslösen, und testen Sie die Zustellung.

Wann Sie das brauchen

Sie möchten, dass Ihr eigenes System reagiert, wenn in Teamspace etwas passiert, zum Beispiel um einen Foto-Upload zu protokollieren oder einen nachgelagerten Job auszulösen. Ein Webhook sorgt dafür, dass Timemark bei jedem ausgewählten Ereignis eine POST-Anfrage an Ihren Endpunkt sendet.

Was Sie brauchen

Rolle: Teaminhaber
Plattform: Web
Plan: Business
Betrifft: Wird nur für Ereignisse ausgelöst, die nach der Erstellung des Webhooks eintreten

Webhook einrichten

Gehen Sie zu Teamspace → Einstellungen → Integrationen → Webhook.
Geben Sie Ihre Endpunkt-URL ein. Sie muss öffentlich erreichbar sein und auf eine POST-Anfrage antworten.
Bestätigen Sie den Auslöser. Der Webhook wird bei Neues Foto ausgelöst, wenn ein neues Foto hochgeladen wird.
Wählen Sie den Geltungsbereich: Alle Fotos oder einen bestimmten Ordner.
Speichern.

Zustellung testen

Verwenden Sie bei dem soeben gespeicherten Webhook die Funktion Test oder Ping, um eine Beispiel-Payload zu senden.
Prüfen Sie die Protokolle Ihres Endpunkts, um zu bestätigen, dass die Payload angekommen ist.
Bestätigen Sie, dass Ihr Endpunkt mit einer 2xx-Antwort geantwortet hat.

Konfigurierbare Felder

Field	What it does	Notes
Endpunkt-URL	Wohin Timemark die POST-Anfrage sendet	Muss öffentlich erreichbar sein und innerhalb des Timeouts mit `2xx` antworten
Auslöser	Die Aktion, die eine Zustellung auslöst	Neues Foto (`photo.uploaded`) ist derzeit der einzige Auslöser. Siehe Webhook-Ereignistypen
Geltungsbereich	Beschränkt die Auslösung auf einen Ordner oder auf alle Team-Fotos	Der Ordner-Geltungsbereich löst nur für Fotos in diesem Ordner aus

Häufige Stolperfallen

Keine rückwirkende Auslösung. Der Webhook wird nur für Ereignisse ausgelöst, die nach seiner Erstellung eintreten. Bestehende Fotos lösen ihn nicht aus.
Der Endpunkt muss rechtzeitig mit 2xx antworten. Ein Timeout oder Fehler wird als fehlgeschlagene Zustellung gewertet. Timemark wiederholt fehlgeschlagene Zustellungen und stoppt, sobald die Wiederholungsversuche ausgeschöpft sind.
Falscher Geltungsbereich. Ein Webhook, der auf einen Ordner beschränkt ist, wird für Fotos in anderen Ordnern nicht ausgelöst. Stellen Sie den Geltungsbereich auf Alle Fotos, wenn Sie jeden Ordner benötigen.
Hinter einer Firewall. Ein Endpunkt hinter einem VPN oder einer Firewall ist nicht erreichbar. Stellen Sie eine öffentliche URL bereit.

Siehe auch

Zuletzt aktualisiert: 28. Juni 2026