API incidento savaitė: trūkstamas idempotentiškumas yra sustabdymas, o ne pakartojimų audra

Kai tinklo sutrikimas nutraukia DLR pristatymą, klientų sistemos pradeda siųsti pasikartojančias užklausas. Be tinkamo idempotentiškumo šis srautas gali greitai nurašyti lėšas iš išankstinio mokėjimo sąskaitų kelis kartus. Sužinokite, kaip įdiegti transakcijų užraktus ir apsaugoti klientų balansus nuo netikėtų tinklo klaidų padarinių.

Vidurnakčio perspėjimas ir tyla linijoje

Jūsų prietaisų skydelis rodo plokščią liniją DLR pristatyme, o įeinantis SMS srautas pasiekia piką. Tinklo padalinimas nutraukė TCP paketus užklausos metu, o kliento mikroservisas manė, kad įvyko gedimas. Be tinkamų apsaugų, automatiniai klientai pradeda bombarduoti šliuzą identiškais duomenimis. Žiūrite į klasikinę pakartojimų audrą prepaid sąskaitoje, kur kiekviena dubliuota užklausa rizikuoja dvigubu balanso nurašymu. white-label prepaid CPaaS modelyje jūsų pirmasis API incidentas niekada nėra tik apie veikimo laiką; tai apie klientų lėšų apsaugą.

Kodėl pakartojimai be apsaugų ištuština prepaid balansus

Kai įvyksta kliento laiko limitas, naivi taikomoji logika nedelsiant siunčia HTTP užklausą iš naujo. Jei jūsų maršrutizavimo sluoksnis apdoroja šiuos dublikatus nepriklausomai, kiekvienas API pasiekimas sukelia naują JIT numerio paskirstymą arba naują SMS siuntimą. Tai pažeidžia USD 20 prepaid grindų logiką, nuleisdami balansą žemiau nulio. Negalite pasitikėti viltimi ar kliento pažadais. Peržiūrėkite mūsų vadovą apie idempotentiškumas, pakartojimai ir pinigai, kad suprastumėte, kaip sandorių blokavimas apsaugo piniginę.

Gedimo izoliavimas ir ciklo sustabdymas

Jūsų neatidėliotina operacinė prioritetas yra stabdyti įeinantį srautą prieš taisant kodą. Įdiekite skubią greičio ribojimo taisyklę API šliuzo pakraštyje, kad atmestumėte identiškus duomenis, gaunamus per siaurą laiko langą. Nebandykite apdoroti sandorių, kol sąskaitos knygos būsena yra ginčytina. Jei jūsų platforma artėja prie USD 1.000 per mėnesį ribos ginčytinam srautui, operatoriai pažymės jūsų prekybininko ID. Nedelsiant užšaldykite paveiktą kliento galinį tašką per administravimo konsolę.

Sandorio būsenos ir knygos suderinamumo tikrinimas

Kai audra nurims, privalote audituoti kiekvieną balanso koregavimą, atliktą incidento metu. Palyginkite vidinius žurnalus su operatoriaus HB signalais, kad rastumėte našlaičių užklausas, kur SMS buvo išsiųstas, o DLR nebuvo įregistruotas. Kūrėjai dažnai įsipareigoja API antrasis mėnuo: Idempotentiškumo skolos valdymas po pirmojo ciklo manydami, kad vienos gijos duomenų bazės apribojimų pakanka. Paskirstyti mikroservisai reikalauja aiškaus maišo pagrindu veikiančio užrakinimo.

Webhook pristatymo apsauga nuo aido pakartojimų

Saugus įeinančių webhook tvarkymas yra toks pat svarbus kaip ir išėjimo API skambučiai incidento metu. Klientai, apdorojantys asinchroninius DLR atnaujinimus, taip pat gali patekti į begalinius ciklus, jei jūsų serveris grąžina 5xx klaidas. Įdiekite griežtą webhook parašas ir pakartojimo langas patikrinimą naudojant kriptografines žymas, kad atmestumėte pasenusius duomenis, senesnius nei 300 sekundžių.

Pradėkite nuo IOSOR, kad užtikrintumėte atsparią operacijų kontrolę

Incidento savaitę pirmiausia užšaldykite naują išeinantį. Pridėkite Idempotency-Key prie kiekvieno inflight siuntimo, eksportuokite dublikatines debeto eilutes ir sustabdykite tylius kliento kartojimus. Neatidarykite kartojimų audros, kad pasivytumėte.

IOSOR santrauka

Darykite: trūkstamus raktus laikykite šaldymu, tada užpildykite ir suderinkite ledger.

Nedarykite: uždaryti incidentą, kol dublikatiniai DLR dar kaldina antrą debetą. Bilieto būsena nėra pinigų būsena.