# Webhooks
Utilisez Webhooks pour recevoir des événements de tâches et de facturation sans interrogation. Tripo envoie des charges utiles JSON à votre point de terminaison HTTPS lorsque des événements souscrits se produisent.
## Configuration
1. Ouvrez Paramètres, puis Webhooks.
2. Ajoutez un point de terminaison HTTPS, tel que `https://api.yourapp.com/tripo-webhook`.
3. Sélectionnez les types d'événements que vous souhaitez recevoir.
4. Enregistrez le point de terminaison.
5. Copiez le secret de signature et stockez-le en toute sécurité. Il n'est affiché qu'une seule fois.
## Types d'événements
| Événement | Descriptif |
| --- | --- |
| `task.completed` | Une tâche terminée avec succès. |
| `task.failed` | Une tâche a échoué ou a été annulée. |
| `balance.low` | Le solde du compte est tombé en dessous du seuil d'alerte de crédit configuré. |
## En-têtes de demande
| En-tête | Descriptif |
| --- | --- |
| `Tripo-Webhook-Id` | Point de terminaison Webhook ID. |
| `Tripo-Webhook-Delivery` | Livraison unique ID. Utilisez-le pour l'idempotence. |
| `Tripo-Webhook-Event` | Type d'événement, tel que `task.completed`. |
| `Tripo-Webhook-Signature` | Signature HMAC-SHA256 sur `{timestamp}.{raw_body}`. |
| `Content-Type` | Toujours `application/json`. |
## Vérification
1. Analysez `t` et `v1` à partir de `Tripo-Webhook-Signature`.
2. Calculez HMAC-SHA256 avec le secret de signature sur `t + "." + rawBody`.
3. Comparez le résumé hexadécimal calculé avec `v1` en utilisant une comparaison à temps constant.
4. Rejetez éventuellement les horodatages datant de plus de cinq minutes environ.
## Meilleures pratiques
- Renvoyez rapidement une réponse `2xx`, puis traitez les travaux lourds de manière asynchrone.
- Vérifiez chaque charge utile avant de modifier l’état de l’application.
- Dédupliquez les événements à l’aide de `Tripo-Webhook-Delivery`.
- Utilisez `balance.low` pour alerter les utilisateurs avant que la création de tâches échoue en raison de crédits insuffisants.
Webhooks
Utilisez Webhooks pour recevoir des événements de tâches et de facturation sans interrogation. Tripo envoie des charges utiles JSON à votre point de terminaison HTTPS lorsque des événements souscrits se produisent.
Configuration
Ouvrez Paramètres, puis Webhooks.
Ajoutez un point de terminaison HTTPS, tel que https://api.yourapp.com/tripo-webhook.
Sélectionnez les types d’événements que vous souhaitez recevoir.
Enregistrez le point de terminaison.
Copiez le secret de signature et stockez-le en toute sécurité. Il n’est affiché qu’une seule fois.
Types d’événements
Événement
Descriptif
task.completed
Une tâche terminée avec succès.
task.failed
Une tâche a échoué ou a été annulée.
balance.low
Le solde du compte est tombé en dessous du seuil d’alerte de crédit configuré.
En-têtes de demande
En-tête
Descriptif
Tripo-Webhook-Id
Point de terminaison Webhook ID.
Tripo-Webhook-Delivery
Livraison unique ID. Utilisez-le pour l’idempotence.
Tripo-Webhook-Event
Type d’événement, tel que task.completed.
Tripo-Webhook-Signature
Signature HMAC-SHA256 sur {timestamp}.{raw_body}.
Content-Type
Toujours application/json.
Vérification
Analysez t et v1 à partir de Tripo-Webhook-Signature.
Calculez HMAC-SHA256 avec le secret de signature sur t + "." + rawBody.
Comparez le résumé hexadécimal calculé avec v1 en utilisant une comparaison à temps constant.
Rejetez éventuellement les horodatages datant de plus de cinq minutes environ.
Meilleures pratiques
Renvoyez rapidement une réponse 2xx, puis traitez les travaux lourds de manière asynchrone.
Vérifiez chaque charge utile avant de modifier l’état de l’application.
Dédupliquez les événements à l’aide de Tripo-Webhook-Delivery.
Utilisez balance.low pour alerter les utilisateurs avant que la création de tâches échoue en raison de crédits insuffisants.
