# 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.
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
Öffnen Sie Einstellungen und dann Webhooks.
Fügen Sie einen HTTPS-Endpunkt hinzu, z. B. https://api.yourapp.com/tripo-webhook.
Wählen Sie die Veranstaltungstypen aus, die Sie erhalten möchten.
Speichern Sie den Endpunkt.
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
Analysieren Sie t und v1 von Tripo-Webhook-Signature.
Berechnen Sie HMAC-SHA256 mit dem Signaturgeheimnis über t + "." + rawBody.
Vergleichen Sie den berechneten Hex-Digest mit v1 mithilfe eines Zeitkonstantenvergleichs.
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.
