Olayları webhooks ile kendi sisteminize gönderin

Bir webhook, bir şey olduğunda, örneğin bir fatura ödendiğinde, IDup'un web adresinizi aramasına olanak tanır. Her teslimat imzalanır ve sisteminiz yanıt vermezse tekrarlanır.

Bir uç nokta ekleyin

1. Aç Webhooks sekmesi ve basın Uç nokta ekleyin.
2. Bir Ad ve URL. Herkese açık olarak erişilebilir olmalıdır. Güvenlik nedenleriyle özel bir ağ içindeki adresler reddedilir.
3. İşaretleyin Etkinlikler istediğiniz.
4. İsteğe bağlı: birini seçin API anahtarı. Uç nokta, bu anahtarın okuyabileceği olayları alır.
5. Basın Kaydet. IDup gösterir İmza sırrınız bir kez. Güvenli bir şekilde saklayın.

Etkinlikler

• Fatura oluşturuldu, Fatura ödendi, Ödeme alındı
• Yeni müşteri, Yeni iletişim, Yeni lead, Yeni bilet
• Teklif kabul edildi — bir müşterinin kabul ettiği teklif

Her teslimat üç başlık taşır: etkinlik adı, teslimat numarası ve imza. Bir yeniden deneme aynı teslimat numarasını korur, böylece sisteminiz kopyaları tanıyabilir.

İmzayı kontrol et

Sisteminiz, zaman ve ham gövde üzerinde gizli anahtarınızla bir HMAC-SHA256 hesaplamalı, bunu imza ile karşılaştırmalı ve 5 dakikadan eski bir zamanı reddetmelidir. Basın İmza ve örnekleri doğrula hazır kod için.

Test edin, duraklatın ve yenileyin

• Test gönder bir test olayı gönderir ve HTTP kodunu ve aldığı süreyi gösterir.
• Duraklat teslimatları durdurur; Aktive et tekrar başlatır.
• Gizli anahtarı döndür yeni bir gizli anahtar oluşturur. Eski anahtar hemen çalışmayı durdurur.
• Sil uç noktayı kaldırır. Günlüğü saklanır.

Tekrar denemeler ve günlük

Adresinizin 5 saniye içinde 2xx kodu ile yanıt vermesi gerekir. Yönlendirmeler takip edilmez. Başarısız olursa, IDup 1 dakika, 5 dakika, 30 dakika, 2 saat ve 12 saat sonra tekrar dener. Altıncı denemeden sonra teslimat işaretlenir. Vazgeçildi.

Günlük, her denemeyi olay, uç nokta, deneme, HTTP kodu, süre ve yanıtın başlangıcı ile gösterir. Durum Bekleme, Teslim edildi, Başarısız veya Vazgeçildi. Kullanın Yeniden gönder bir teslimatı tekrar göndermek için.