IOSOR

IOSOR Vedomosti

API pilotný týždeň: Kľúče a webhooky na live prevádzke

Spustite svoj prvý produkčný týždeň na IOSOR s podpísanými webhookmi, kľúčmi idempotencie, live DLR sledovaním a bezpečnosťou predplateného zostatku.

API pilotný týždeň: Kľúče a webhooky na live prevádzke.

Propagácia API kľúčov do produkčnej premávky

Prechod zo staging testov na live prevádzku vyžaduje izoláciu operačných tokenov. Počas vášho API pilotného týždňa nahraďte dočasné testovacie tokeny obmedzenými produkčnými kľúčmi. Produkčné kľúče by mali mať explicitné rozsahy, ktoré umožňujú iba odosielanie SMS alebo príjem webhookov bez globálnych administratívnych práv. Uistite sa, že vaše live API poverenia sú uložené v bezpečných úložiskách.

Overovanie podpísaných webhookov na reálnych streamoch

Prijímanie správ o doručení v reálnom čase (DLR) a prichádzajúcich správ vyžaduje kryptografické overenie. Každá dátová payload odoslaná na vašu spätnú URL adresu obsahuje hash podpis vypočítaný vaším tajným kľúčom. Pred prijatím akejkoľvek aktualizácie doručenia overte podpis hlavičky HTTP, aby ste zablokovali falošné udalosti. Vždy skontrolujte toleranciu časovej pečiatky oproti [signature replay].

Kľúče idempotencie a zrážky zostatku

Sieťové výpadky počas pilotného týždňa môžu spôsobiť duplicitné požiadavky HTTP POST z vašej aplikácie. Poskytnutie jedinečnej hlavičky Idempotency-Key pri každom volaní zaručuje, že duplicitné pokusy nikdy nespustia dvojité účtovanie alebo duplicitné odoslanie SMS. Pozrite si nášho sprievodcu «idempotencia, opakovania a peniaze» na /learn/developers/api-idempotency-retries-and-money, aby ste pochopili, ako idempotencia chráni vaše peniaze.

Spracovanie správ o doručení a zlyhaní webhookov

Živé siete operátorov generujú asymetrické oneskorenia DLR. Vaša aplikácia musí spracovávať webhooky asynchrónne pomocou interného frontu udalostí. Ak koncový bod príjemcu stratí pripojenie alebo vráti chyby 5xx, platforma spustí automatické opakované pokusy s exponenciálnym oneskorením. Udržujte prísnu idempotenciu pri prichádzajúcich DLR payloadoch pomocou UUID správy.

Prahové hodnoty účtu a škálovanie prevádzky

Pilotný týždeň prináša reálnu dynamiku prevádzky v rámci predvídateľných finančných hraníc. Aktivácia účtu začína s predplatenou hranicou 20 USD, čo zaisťuje, že zostatok nikdy neklesne pod limity rezerv. S rastom priepustnosti správ a blížiacou sa mäkkou revíziou blízko 1 000 USD/mesiac sa operačné limity dynamicky upravujú bez prerušenia API pripojenia.

Začnite s IOSOR

Vydajte kľúč s rozsahom production — nie sandbox token — a nasmerujte callback na podpísanú webhook URL, ktorú ovládate. Odošlite jeden OTP alebo upozornenie s Idempotency-Key. Potvrďte, že prepaid hold, debet aj DLR dopadli na rovnaký zámer. Odznak Live bez vyhradeného kľúča a overeného podpisu je stále setup.

idempotencia, opakovania a peniaze API incident týždňa: chýbajúca idempotencia je zmrazenie, nie opakovaná búrka rezervácia predplateného zostatku pred prvým odpísaním.

Zhrnutie IOSOR

Robte: prvý živý týždeň veďte na production kľúči, podpísanom webhooku a jednom prepaid holde viditeľnom v ledgeri.

Nerobte: dávať sandbox token na živú prevádzku ani brať nepodpísaný callback ako dosť pre pilot.

Pomohol tento sprievodca?

Súvisiace návody