Incident nedelje API-ja: Nedostatak idempotentnosti je zamrzavanje, a ne oluja ponavljanja

Kada mrežni prekid zaustavi isporuku DLR izveštaja, klijentske aplikacije automatski šalju identične zahteve iznova. Bez idempotentnosti, ova oluja ponovljenih API poziva preti da višestruko zaduži prepaid balanse korisnika. Saznajte kako da implementirate transakciono zaključavanje i sprečite neželjeno trošenje sredstava klijenta.

Ponoćni alarm i tišina na vezi

Vaš kontrolni panel pokazuje ravnu liniju kod DLR isporuke dok dolazni SMS saobraćaj skače. Mrežna podela je prekinula TCP pakete u toku zahteva, a mikrousluga vašeg klijenta je pretpostavila neuspeh. Bez odgovarajućih zaštita, automatski klijenti kreću da bombarduju gejtvej identičnim payload-ima. Gledate u klasičnu oluju ponavljanja protiv prepaid knjige gde svaki duplirani zahtev rizikuje duplo zaduženje balansa. U white-label prepaid CPaaS modelima, vaš prvi API incident nikada nije samo u vezi sa radnim vremenom; reč je o zaštiti sredstava klijenta od kaskadnih mrežnih kvarova.

Zašto ponavljanja bez zaštite prazne prepaid balanse

Kada dođe do isteka vremena klijenta, naivna logika aplikacije odmah ponovo šalje HTTP zahtev. Ako vaš sloj za rute obrađuje ove duplikate nezavisno, svaki API pogodak pokreće novu JIT alokaciju brojeva ili novo slanje SMS-a. Ovo krši logiku prepaid praga od USD 20 spuštanjem balansa ispod nule pre nego što sistem rizika to registruje. Ne možete se osloniti na nadu ili obećanja sa strane klijenta. Pogledajte naš vodič o идемпотентност, понављања и новац da shvatite kako zaključavanja transakcija sprečavaju slučajno pražnjenje novčanika tokom ponovnog povezivanja.

Izolacija kvara i zaustavljanje petlje

Vaš neposredni operativni prioritet je zaustavljanje dolaznog saobraćaja pre krpljenja koda. Implementirajte hitno pravilo ograničenja brzine na ivici API gejtveja da odbacite identične payload-e koji stižu unutar uskog vremenskog prozora. Ne pokušavajte da obrađujete transakcije dok je stanje knjige osporeno. Ako se vaša platforma približi mekom pregledu blizu praga od USD 1.000 mesečno u spornom obimu saobraćaja, uzvodni operateri će označiti vaš merchantski ID zbog sumnjive nestabilnosti. Odmah zamrznite pogođeni klijentski kraj preko vaše administrativne konzole.

Provera stanja transakcija i konzistentnosti knjige

Kada se oluja smiri, morate revidirati svako prilagođavanje balansa napravljeno tokom prozora incidenta. Uporedite interne dnevnike knjige sa signalima HB operatera da identifikujete siroče zahteve gde je SMS poslat, a DLR isporuka nije zabeležena. Programeri često prave Drugi mesec API-ja: Upravljanje dugom idempotentnosti nakon prvog ciklusa pretpostavljajući da su jednolinijska ograničenja baze dovoljna. Nisu. Distribuirane mikrousluge zahtevaju eksplicitno zaključavanje zahteva zasnovano na heševima.

Obezbeđivanje isporuke veb-huka protiv eho ponavljanja

Sigurno rukovanje dolaznim veb-huk pozivima je jednako važno kao i upravljanje odlaznim API pozivima tokom incidenta. Klijenti koji obrađuju asinhrone DLR ažuriranja takođe mogu upasti u beskonačne petlje ako vaš server vrati 5xx greške zbog sukoba zaključavanja baze. Implementirajte strogu proveru потпис вебхука и прозор понављања koristeći kriptografske vremenske oznake da odbacite stare payload-e starije od 300 sekundi.

Počnite sa platformom IOSOR za otpornu kontrolu transakcija

У недељи инцидента прво замрзните нови одлазни. Додајте Idempotency-Key на сваки inflight send, извезите дуплиране дебит редове и зауставите тихе клијентске поновне покушаје. Не отварајте олују понављања да стигнете.

Резиме IOSOR

Радите: недостајуће кључеве третирајте као freeze, затим попуните и ускладите ledger.

Не радите: затварати инцидент док дуплирани DLR још кује други дебит. Статус тикета није новчани статус.