Müasir API inteqrasiyalarında yalnız məlumat göndərmək və ya əldə etmək deyil, bütün hadisələrin bir dəfə, düzgün və etibarlı şəkildə işlənməsinə zəmanət vermək vacibdir. Biz xarici xidmətlər və növbələr ilə işdə itkilər və dublların qarşısını almaq üçün aralıq vəziyyətləri, təkrar çatdırılma mexanizmləri (retries) və mesajların təkrarlanması ilə arxitekturanı həyata keçiririk.
Bu, bir dəfəlik və tamamlanmanın kritik olduğu əməliyyatlar, ödəniş şlüzləri, webhook hadisələri və fon vəzifələri ilə işləyərkən xüsusilə vacibdir.
Nə həyata keçirildi
| Mexanizm | Təyinat və üstünlüklər |
|---|---|
| Vəziyyətin qorunması | Uğursuzluq yerindən davam etmək və ya emal tərəqqisini izləmək imkanı |
| Avtomatik retries | Hata zamanı yenidən cəhd, eksponensial gecikmə ilə |
| Deduplication | Eyni sorğuların və ya hadisələrin ikiqat emalına qarşı qorunma |
| Hadisə identifikatorları | Dəstək 'event _ id', 'message _ id', hash-trekinq |
| Təxirə salınmış tapşırıqlar | Xarici xidmət müvəqqəti olaraq mövcud deyilsə, daha sonra yenidən cəhd edin |
Bu necə işləyir
1. Daxil olan sorğu və ya hadisə unikal identifikator alır
2. Qeyd emal jurnalına əlavə olunur (DB, Redis və ya Kafka)
3. Səhv olarsa, tapşırıq retry-də növbəyə qoyulur (limit və nəzarət ilə)
4. Eyni hadisəni yenidən aldıqda - sistem onun şəxsiyyətini yoxlayır və dublikatını rədd edir
5. Bütün hadisə tarixi və emal vəziyyəti audit üçün mövcuddur
API və platforma üçün üstünlüklər
Şəbəkə uğursuzluqları, təkrar webhook 'ax və ya müştəri səhvləri zamanı dublların istisna edilməsi
Müvəqqəti problemlərdə belə etibarlı çatdırılma
Xarici API və bazalarda yükü minimuma endirmək
Dəqiq giriş, audit və bərpa imkanı
Müxtəlif ssenarilər (ödənişlər, bonuslar, hadisələr) üçün ölçülənlik və çeviklik
Harada xüsusilə vacibdir
Maliyyə əməliyyatları, billing, depozitlər
Oyun tədbirləri: bahislər, uduşlar, hesablaşmalar
Webhook və yavaş API ilə inteqrasiya
Yüksək yük və arxa plan tapşırıqları ilə memarlıq
States, retries və deduplication API inteqrasiyasını sabit edən bir şeydir. Biz məntiqi belə layihələndiririk ki, hətta uğursuzluqlar və qeyri-sabit birləşmələr şəraitində məlumatlarınız təhlükəsiz olsun, proseslər isə dublikatsız olaraq tamamlansın.