# Webhooks Yoklama olmadan görev ve faturalama olaylarını almak için Webhooks'yi kullanın. Tripo, abone olunan olaylar gerçekleştiğinde JSON veri yüklerini HTTPS uç noktanıza gönderir. ## Kurulum 1. Ayarlar'ı ve ardından Webhooks'yi açın. 2. `https://api.yourapp.com/tripo-webhook` gibi bir HTTPS uç noktası ekleyin. 3. Almak istediğiniz etkinlik türlerini seçin. 4. Uç noktayı kaydedin. 5. İmzalama sırrını kopyalayın ve güvenli bir şekilde saklayın. Yalnızca bir kez gösterilir. ## Etkinlik Türleri | Etkinlik | Açıklama | | --- | --- | | `task.completed` | Bir görev başarıyla tamamlandı. | | `task.failed` | Bir görev başarısız oldu veya iptal edildi. | | `balance.low` | Hesap bakiyesi yapılandırılmış kredi uyarısı eşiğinin altına düştü. | ## Başlıkları Talep Et | Başlık | Açıklama | | --- | --- | | `Tripo-Webhook-Id` | Webhook uç noktası ID. | | `Tripo-Webhook-Delivery` | Benzersiz teslimat ID. İdempotens için kullanın. | | `Tripo-Webhook-Event` | `task.completed` gibi olay türü. | | `Tripo-Webhook-Signature` | `{timestamp}.{raw_body}` üzerinde HMAC-SHA256 imzası. | | `Content-Type` | Her zaman `application/json`. | ## Doğrulama 1. `Tripo-Webhook-Signature`'den `t` ve `v1`'yi ayrıştırın. 2. HMAC-SHA256'yi `t + "." + rawBody` üzerindeki imzalama sırrıyla hesaplayın. 3. Sabit zamanlı bir karşılaştırma kullanarak hesaplanan onaltılık özeti `v1` ile karşılaştırın. 4. İsteğe bağlı olarak yaklaşık beş dakikadan daha eski zaman damgalarını reddedin. ## En İyi Uygulamalar - Hızla bir `2xx` yanıtı gönderin, ardından ağır işleri eşzamansız olarak işleyin. - Uygulama durumunu değiştirmeden önce her veriyi doğrulayın. - `Tripo-Webhook-Delivery` kullanarak etkinlikleri tekilleştirin. - Yetersiz kredi nedeniyle görev oluşturma başarısız olmadan önce kullanıcıları uyarmak için `balance.low`'yi kullanın.