Fonzip'te gerçekleşen belli olayları web tetikleyiciler sayesinde kendi sunucularınıza bildirebilir ve ilgili olayları kendi sisteminize kaydedebilirsiniz.
Web tetikleyicisi nedir? Nasıl oluşturabilirim?
Web tetikleyicileri, sistemde bir olay olduğu zaman istediğiniz adrese bildirim gönderen bir özelliktir. Soldaki menüden Ayarlar > Gelişmiş > Web Tetikleyicileri bölümüne geldikten sonra Web Tetiklemesi Oluştur diyerek bir web tetiklemesi oluşturabilirsiniz.
Oluşturma ekranında tetikleyici adı ve isteğin gitmesini istediğiniz adresi girin. Hangi durumların gelmesini istediğinizi seçin ve kaydedin.
Sağ taraftaki işlemler bölümünden ilgili web tetikleyicisini test edebilirsiniz.
Web tetikleyicisi içeriği nedir?
https://fonzip.com/api/v2/docs#operation/createWebhook bölümünde belirtildiği gibi web tetikleyicisi için belirttiğiniz URL'e bir JSON gönderilmektedir.
{
"id": 0,
"webhook_id": 0,
"operation": 1,
"status": 0
}
id: İlgili objenin kayıt numarası
webhook_id: Web tetikleyicinizin ID'si
operation: işlem türü ( 1: Bağış, 2: Aidat, 3: Bilet, 4: Form, 5: E-kart, 6: Bağış kampanyası)
status: işlem durumu (0: kampanya yaratıldı, 3: başarılı, 4: iade, 5: hata)
Web tetikleyicisi isteği geldi, ne yapmalıyım?
Web tetikleyicisi isteği sisteminize geldikten sonra ilgili işlemin kayıt numarasıyla beraber API ile bağlanıp sisteminize çekebilirsiniz.
Örnek olarak bir bağış gerçekleştiğinde sisteminize istek gelirse Bağış Detayını Getir fonksiyonuyla ( https://fonzip.com/api/v2/docs#operation/getDonationDetails ) bağış detayını çağırabilir ve sisteminize kaydedebilirsiniz.
Web tetikleyicisi gelmedi / Geldi ama hata oluştu, ne yapmalıyım?
Fonzip bir işlemin tetiklemesini 3 defa dener ve eğer başarısız olursa bir daha denemez. Olası problemlere karşı günde 1 defa günlük işlemleri listeleyip toplam işlem sayısını kendi sisteminizle karşılaştırabilir ve eksik olanları listelemeden çekebilirsiniz.
Örnek olarak Bağışları Listele fonksiyonuyla https://fonzip.com/api/v2/docs#operation/getDonationList bir önceki gün olan tüm bağışları listelediğinizdeki total parametresini kendi sisteminizle karşılaştırabilirsiniz. Bu istekleri yaparken zaman dilimine göre sorgu yapmayı ihmal etmeyin.