Bu nədir
İdempotentlik açarları üçün auditor. Qeydə alınmış sorğuları düzgün işləyən API'nin əməl etdiyi qaydalara görə yenidən oynadır və hər birini ilk yazma, təhlükəsiz təkrar və ya problem kimi dəftərə yazır.
Ödəniş və sifariş API'ləri üçün idempotentlik auditi
API'nizin iki dəfə pul tutduğu sorğuları tapın.
Idempotency Ledger sorğu qeydlərinizi oxuyur, hər yazma sorğusunu öz idempotentlik açarı altında dəftərə yazır və təkrar cəhdin harada ikinci ödəniş, ikinci sifariş və ya ikinci köçürmə yaratdığını göstərir. Hər problemin yanında risk altındakı məbləğ və həlli verilir.
Açarlara görə ödənişlərNo. 0417
| Vaxt | Açar | Məbləğ |
|---|---|---|
| 10:00:00 | ik_7f3a | 49.99 |
| 10:00:03 | ik_7f3a | 49.99 |
| 10:05:00 | ik_c044 | 89.00 |
| 10:05:00 | ik_c044 | 89.00 |
| 10:12:00 | ik_f611 | 9.99 |
Artıq tutulan+89.00 EUR
Kimin üçündür
Müştəridən həqiqətən iki dəfə pul tutulduğunu və bunun səbəbini bilməli olan backend və ödəniş mühəndisləri, SRE komandaları və dəstək rəhbərləri üçün.
Hansı problemi həll edir
Təkrar cəhdlər normaldır, amma işi yenidən icra edən təkrar real pul problemləri yaradır. Qeydlər onları minlərlə sətir arasında gizlədir. Dəftər onları cəmlərlə birlikdə ən yuxarıya çıxarır.
Sorğu qeydinizi yoxlayın
Qeyd ixracını yapışdırın və ya fayl açın. Heç nə yüklənmir: təhlil və yoxlamalar bu səhifədə aparılır.
Hər sətirdə bir sorğu, JSON massivi və ya başlıq sətri olan CSV.
Sahələr adlarına görə tapılır: time və ya ts, method, path və ya url, status, idempotentlik açarı, charge_id və ya order_id kimi yaradılan obyektin identifikatoru, amount, currency və customer. İç içə JSON və Idempotency-Key başlıqları da işləyir.
Yoxlamanın nəticəsi burada görünəcək
Qeydi yapışdırıb Qeydi yoxla düyməsini basın və ya bütün nəticə növlərini görmək üçün nümunəni yükləyin.
Dəftər nələri qeyd edir
Təkrarlanan hər açar zaman ardıcıllığı ilə yoxlanılır və düzgün işləyən serverin etməli olduğu ilə müqayisə edilir.
İkiqat təsir
Eyni açar, eyni sorğu, yaradılmış iki fərqli identifikator. Server işi iki dəfə görüb. Ən baha başa gələn hal budur.
Yarış
İki nüsxə iki saniyə ərzində gəldi və hər ikisi uğurlu oldu. İkiqat kliklərdə və aqressiv təkrar cəhdlərdə çox vaxt baş verir.
Məzmun uyğunsuzluğu
Köhnə açar yeni parametrlərlə gəldi. Düzgün server bunu 422 ilə rədd edir. Qəbul etmək müştəri xətalarını gizlədir.
Qismən uğursuzluq
Yenə də obyekt yaradan 5xx, ardınca daha birini yaradan təkrar cəhd. Yalnız qeydlərdə identifikator olduqda görünür.
Açar yoxdur
Açarsız yazmaların təkrarını aradan qaldırmaq olmur. Vaxtca yaxın iki eyni yazma təkrar kimi qeyd olunur.
Müddəti bitmiş açar
Müddətdən sonra qayıdan açar yeni iş sayılır. Müddəti serverinizə uyğun seçin.
Necə istifadə etməli
Qeydi ixrac edin
Gateway, yük balansı və ya tətbiq qeydlərindən bir endpoint və ya xidmətə gələn sorğuları müəyyən vaxt aralığı üçün götürün.
Yapışdırın və ya açın
JSON sətirləri, JSON massivi, başlıqlı CSV və ya key=value cütləri olan adi sətirlər işləyir.
Açar müddətini seçin
Serverinizin açarları nə qədər saxladığını seçin. Stripe üslubunda API'lər 24 saat istifadə edir.
Dəftəri oxuyun
Problemlər risk altındakı məbləğlə birlikdə ən yuxarıda göstərilir. Hər sətri və həlli görmək üçün açarı açın, sonra hesabatı kopyalayın və ya CSV faylını yükləyin.
Bilmək faydalıdır
- İkiqat təsir yalnız qeyddə yaradılan obyektin identifikatoru olduqda sübut olunur. İdentifikator olmadıqda təkrarlar düzgün təkrar kimi yazılır.
- Sorğular metod, yol və gövdəyə görə, gövdə olmadıqda isə məbləğ, valyuta və müştəriyə görə müqayisə olunur.
- Vaxtlar UTC ilə göstərilir, saat qurşağı olmayan vaxtlar da UTC kimi oxunur. Vaxtı olmayan sətirlər faylın sırasını saxlayır.
- Böyük qeydlər də işləyir, amma daha sürətli oxumaq üçün onları sizə lazım olan endpointlərlə məhdudlaşdırın.
- Heç nə brauzerinizdən çıxmır. Yenə də hesabatı paylaşmazdan əvvəl kart nömrələrini və şəxsi məlumatları silin.
Suallar
İdempotentlik açarı nədir?
Müştərinin yazma sorğusu ilə göndərdiyi unikal dəyər. Eyni sorğu eyni açarla yenidən gələrsə, server işi ikinci dəfə görmək əvəzinə ilk nəticəni qaytarır.
409 niyə düzgün sayılır?
Bu o deməkdir ki, birincisi hələ icra olunarkən ikinci nüsxə gəlib və server onları paralel işə salmaqdan imtina edib. Müştəri sonra yenidən cəhd edib saxlanmış nəticəni ala bilər.
Yalnız bir dəfə pul tutulubsa, məzmun uyğunsuzluğu niyə vacibdir?
Köhnə açarla yeni parametrləri qəbul etmək müştəri tətbiqində açarları təkrar işlədən xəta olduğunu göstərir. Növbəti dəfə o, təkrar kimi görünən səhv bir ödəniş yaradacaq.
Qeydlərimdə identifikator olmalıdır?
Onlar yoxlamanı dəqiq edir. Hər yazmanın yaratdığı obyektin identifikatorunu, məsələn charge_id və ya order_id dəyərini qeydə yazın.