Zpracování chyb HTTP 402 a 429 v API

Zpracování chyb HTTP 402 a 429 v API.

Pochopení HTTP stavové architektury předplaceného CPaaS

Při budování automatizovaných komunikačních integrací se software spoléhá na předvídatelné HTTP odpovědi pro udržení provozuschopnosti. Na rozdíl od standardního softwaru s platbou pozadu funguje white-label předplacené CPaaS na přísném zůstatku a modelu financování v reálném čase. Každý požadavek API spouští okamžité kontroly oprávnění oproti aktivnímu zůstatku peněženky. Protože prostředky musí být dostupné v momentě provedení, vaše architektura musí nakládat s finančním stavem striktně.

Anatomie chyby HTTP 402 Payment Required

Stavový kód HTTP 402 označuje, že operace selhala, protože zůstatek na vašem účtu je vyčerpán nebo nedostačuje na pokrytí nákladů. Například zřízení telefonního čísla vyžaduje dostatečné prostředky pro počáteční alokaci, což odpovídá našemu JIT a předplacenému workflow. Pokud váš zůstatek klesne pod USD 20, brána okamžitě odmítne payloady s chybou 402. Považovat toto za přechodnou síťovou chybu je klasická past.

Anatomie chyby HTTP 429 Too Many Requests

Naproti tomu odpověď HTTP 429 signalizuje omezení rychlosti vyvolané překročením limitů propustnosti, jako je odeslání příliš mnoha požadavků za sekundu. Zatímco chyba 402 značí finanční zablokování, chyba 429 je čistě provozní a dočasná. Když váš systém narazí na stav 429, hlavičky odpovědi obvykle obsahují direktivu informující o tom, kolik sekund by měl váš worker pozastavit činnost. Implementace jitteru je zde nezbytná.

Návrh chytrých politik opakování a jističů

Psaní odolného kódu vyžaduje rozdělení správy chyb do různých větví na základě stavového kódu. Pro HTTP 429 implementujte smyčku opakování s náhodným zpožděním a přísnými limity. Pro HTTP 402 aktivujte jistič, který pozastaví odchozí provoz, spustí automatické navýšení zůstatku nebo upozorní správce a čeká na potvrzení z webhooku. Nikdy neopakujte požadavek 402 bez změny stavu zůstatku.

Integrace kontroly zůstatku s omezením rychlosti

Pro optimalizaci výkonu systému kombinujte předběžné kontroly zůstatku s inteligentní správou front. Před spuštěním hromadných kampaní ověřte zůstatek na účtu, abyste zajistili splnění minimálního provozního prahu. Správná klasifikace chyb se přímo váže k širšímu zdraví platformy a bezpečnosti transakcí. Podrobnější přehled těchto vzorů naleznete v naší dokumentaci.

Začněte s IOSOR pro spolehlivou CPaaS infrastrukturu

Rozvětěte klienta: HTTP 402 znamená, že předplacený hold selhal nebo peněženka nemůže vypořádat — zastavte záměr, ukažte dobití, neopakujte. HTTP 429 znamená, že okno tempa je plné — cteťte Retry-After a pošlete stejný Idempotency-Key. Jeden handler, který opakuje oba kódy, vyrazí druhou bouři debetů.

Související: idempotence, opakování a peníze · API incident: Chybějící idempotence znamená zmrazení, ne bouři · rezervace předplaceného zůstatku před prvním stržením.

Shrnutí IOSOR

402 je peněžní stop; 429 je pauza tempa. Není to stejné opakování.

Dělejte: stůjte na 402, než nový hold dokáže vypořádat; na 429 couvejte s původním klíčem, aby prepaid viděl jeden záměr.

Nedělejte: brát 402 jako měkké 429, ani tlouct kterýkoli kód do 200, zatímco ledger ještě rozhoduje.