# Webhooks Verwenden Sie Webhooks, um Aufgaben- und Abrechnungsereignisse ohne Abfrage zu empfangen. Tripo sendet JSON-Nutzlasten an Ihren HTTPS-Endpunkt, wenn abonnierte Ereignisse auftreten. ## Einrichtung 1. Öffnen Sie Einstellungen und dann Webhooks. 2. Fügen Sie einen HTTPS-Endpunkt hinzu, z. B. `https://api.yourapp.com/tripo-webhook`. 3. Wählen Sie die Veranstaltungstypen aus, die Sie erhalten möchten. 4. Speichern Sie den Endpunkt. 5. Kopieren Sie das Signaturgeheimnis und bewahren Sie es sicher auf. Es wird nur einmal angezeigt. ## Ereignistypen | Veranstaltung | Beschreibung | | --- | --- | | `task.completed` | Eine Aufgabe wurde erfolgreich abgeschlossen. | | `task.failed` | Eine Aufgabe ist fehlgeschlagen oder wurde abgebrochen. | | `balance.low` | Der Kontostand ist unter den konfigurierten Schwellenwert für die Kreditwarnung gefallen. | ## Anforderungsheader | Kopfzeile | Beschreibung | | --- | --- | | `Tripo-Webhook-Id` | Webhook Endpunkt ID. | | `Tripo-Webhook-Delivery` | Einmalige Lieferung ID. Verwenden Sie es für Idempotenz. | | `Tripo-Webhook-Event` | Ereignistyp, z. B. `task.completed`. | | `Tripo-Webhook-Signature` | HMAC-SHA256-Signatur über `{timestamp}.{raw_body}`. | | `Content-Type` | Immer `application/json`. | ## Überprüfung 1. Analysieren Sie `t` und `v1` von `Tripo-Webhook-Signature`. 2. Berechnen Sie HMAC-SHA256 mit dem Signaturgeheimnis über `t + "." + rawBody`. 3. Vergleichen Sie den berechneten Hex-Digest mit `v1` mithilfe eines Zeitkonstantenvergleichs. 4. Lehnen Sie optional Zeitstempel ab, die älter als etwa fünf Minuten sind. ## Best Practices - Geben Sie schnell eine `2xx`-Antwort zurück und verarbeiten Sie dann schwere Aufgaben asynchron. - Überprüfen Sie jede Nutzlast, bevor Sie den Anwendungsstatus ändern. - Deduplizieren Sie Ereignisse mit `Tripo-Webhook-Delivery`. - Verwenden Sie `balance.low`, um Benutzer zu benachrichtigen, bevor die Aufgabenerstellung aufgrund unzureichender Credits fehlschlägt.