# Webhooks Utilizza Webhooks per ricevere eventi di attività e fatturazione senza polling. Tripo invia payload JSON al tuo endpoint HTTPS quando si verificano eventi sottoscritti. ## Installazione 1. Apri Impostazioni, quindi Webhooks. 2. Aggiungi un endpoint HTTPS, come `https://api.yourapp.com/tripo-webhook`. 3. Seleziona i tipi di eventi che desideri ricevere. 4. Salvare l'endpoint. 5. Copia il segreto della firma e archivialo in modo sicuro. Viene mostrato una sola volta. ## Tipi di eventi | Evento | Descrizione | | --- | --- | | `task.completed` | Un'attività è stata completata con successo. | | `task.failed` | Un'attività non è riuscita o è stata annullata. | | `balance.low` | Il saldo del conto è sceso al di sotto della soglia di avviso di credito configurata. | ## Richiedi intestazioni | Intestazione | Descrizione | | --- | --- | | `Tripo-Webhook-Id` | Punto finale Webhook ID. | | `Tripo-Webhook-Delivery` | Consegna unica ID. Usalo per l'idempotenza. | | `Tripo-Webhook-Event` | Tipo di evento, ad esempio `task.completed`. | | `Tripo-Webhook-Signature` | Firma HMAC-SHA256 su `{timestamp}.{raw_body}`. | | `Content-Type` | Sempre `application/json`. | ## Verifica 1. Analizzare `t` e `v1` da `Tripo-Webhook-Signature`. 2. Calcola HMAC-SHA256 con il segreto della firma su `t + "." + rawBody`. 3. Confrontare il digest esadecimale calcolato con `v1` utilizzando un confronto a tempo costante. 4. Facoltativamente, rifiuta i timestamp più vecchi di circa cinque minuti. ## Migliori pratiche - Restituisci rapidamente una risposta `2xx`, quindi elabora il lavoro pesante in modo asincrono. - Verifica ogni payload prima di modificare lo stato dell'applicazione. - Deduplica eventi utilizzando `Tripo-Webhook-Delivery`. - Utilizza `balance.low` per avvisare gli utenti prima che la creazione dell'attività fallisca a causa di crediti insufficienti.