Gerçek bir webhook dağıtıcısı. Bir abonelik kaydedin, bir olay tetikleyin ve arka uç, URL'nize (örneğin https://webhook.site). Teslimat girişimlerini inceleyin, başarısızlıkları tekrar oynatın ve X-FunAPI-Signature başlığında gönderilen gerçek HMAC-SHA256 yük imzasını doğrulayın.
Temel URL: https://funapi.dev/api/webhooks/v1 · 8 uç nokta · OpenAPI 3.1 belgesi ve Postman koleksiyonu mevcut. Yeni misiniz? Önce şunu okuyun: başlangıç rehberi.
Kimlere ve hangi konularda bildirim gönderiliyor?
POST /webhooks/v1/subscriptions — Webhook aboneliği kaydı oluşturun (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 201 400 401 Bu uç noktanın bağlantısıGET /webhooks/v1/subscriptions — Webhook aboneliklerinin listesi (gizli bilgiler gizlenmiştir) (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 200 Bu uç noktanın bağlantısıDELETE /webhooks/v1/subscriptions/{id} — Abonelikten çık (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 204 401 403 404 Bu uç noktanın bağlantısıdenemeler, tekrarlar ve imza kontrolleri
POST /webhooks/v1/trigger — Eşleşen tüm aboneliklere bir olay gönder (gerçek HTTP POST). (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 200 201 400 Bu uç noktanın bağlantısıGET /webhooks/v1/deliveries — Teslimat girişimlerini listeleyin, duruma veya aboneliğe göre filtreleyin. (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 200 400 Bu uç noktanın bağlantısıPOST /webhooks/v1/deliveries/{id}/replay — Teslimat girişimini tekrarla — gerçek HTTP POST isteğini yeniden gönderir (3 denemeden sonra 409 hatası). (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 200 401 404 409 Bu uç noktanın bağlantısıPOST /webhooks/v1/verify-signature — Veri paketinin imzasını doğrulayın (gerçek HMAC-SHA256) · Yanıt kodları: 200 400 Bu uç noktanın bağlantısıPOST /webhooks/v1/ordering — Dışarıya istek yapmadan kopyalanmış ve ters sıralı zarflar üretin (Bearer kimlik doğrulaması gerekir) · Yanıt kodları: 200 400 401 404 409 422 Bu uç noktanın bağlantısıWebhooks API'si sorunun alıcı tarafıdır: bir geri çağırma URL'si kaydedin, bir olayı tetikleyin, ardından tam olarak neyin iletildiğini inceleyin ve tekrar oynatın. Teslimatlar HMAC ile imzalanır, böylece bir imzayı doğrulama pratiği yapabilirsiniz; bu, gerçek bir doğrulayıcıyı dize eşitliği kontrolünden ayıran sabit zamanlı karşılaştırma ve tekrar oynatma penceresini de içerir.
Son güncelleme