IOSOR

IOSOR Znanje

API pilot tjedan: Ključevi i webhookovi na live prometu

Pokrenite svoj prvi produkcijski tjedan na IOSOR-u uz potpisane webhookove, ključeve idempotentnosti, live DLR praćenje i sigurnost prepaid stanja.

API pilot tjedan: Ključevi i webhookovi na live prometu.

Promicanje API ključeva u produkcijski promet

Prijelaz sa staging testova na live promet zahtijeva izolaciju operativnih tokena. Tijekom API pilot tjedna zamijenite privremene testne tokene ograničenim produkcijskim ključevima. Produkcijski ključevi trebaju nositi izričite opsege, dopuštajući samo odlazno slanje SMS-ova ili dolaznu integraciju webhookova bez globalnih administrativnih prava. Provjerite nalaze li se vaši live API akreditivi u sigurnim trezorima.

Potvrđivanje potpisanih webhookova na stvarnim streamovima

Primanje izvješća o isporuci u stvarnom vremenu (DLR) i dolaznih poruka zahtijeva kriptografsku verifikaciju. Svaki korisni teret poslan na vaš callback URL uključuje hash potpis izračunat vašim tajnim ključem. Prije prihvaćanja bilo kakvog ažuriranja isporuke, provjerite potpis HTTP zaglavlja kako biste blokirali lažirane događaje. Uvijek provjerite toleranciju vremenske oznake protiv [signature replay].

Ključevi idempotentnosti i odbici stanja

Mrežne smetnje tijekom pilot tjedna mogu uzrokovati dvostruke HTTP POST zahtjeve iz vaše aplikacije. Pružanje jedinstvenog Idempotency-Key zaglavlja sa svakim pozivom osigurava da dvostruki pokušaji nikada ne pokrenu dvostruku naplatu ili dvostruki prijenos SMS-a. Pogledajte naš vodič o «idempotentnost, ponavljanja i novac» na /learn/developers/api-idempotency-retries-and-money kako biste shvatili kako idempotentnost štiti vaš saldo.

Rukovanje izvješćima o isporuci i pogreškama webhooka

Live mreže operatera generiraju asimetrična kašnjenja DLR-a. Vaša aplikacija mora asinkrono obrađivati webhookove koristeći interni red čekanja događaja. Ako krajnja točka primatelja prekine veze ili vrati 5xx pogreške, platforma pokreće automatizirane pokušaje s eksponencijalnim odmakom. Održavajte striktnu idempotentnost na dolaznim DLR payloadima koristeći UUID poruke.

Pragovi računa i skaliranje prometa

Pilot tjedan uvodi stvarnu dinamiku prometa pod predvidljivim financijskim granicama. Aktivacija računa počinje s prepaid pragom od 20 USD, osiguravajući da stanje nikada ne padne ispod operativnih rezervnih granica. Kako protok poruka raste i integracija se približava mekoj provjeri blizu 1000 USD mjesečno, operativne granice se dinamički prilagođavaju bez prekida API konektivnosti.

Započnite s IOSOR-om

Izdajte ključ s opsegom production — ne sandbox token — i usmjerite callback na potpisani webhook URL koji kontrolirate. Pošaljite jedan OTP ili alert s Idempotency-Key. Potvrdite da prepaid hold, debit i DLR padaju na istu namjeru. Live značka bez posvećenog ključa i provjerenog potpisa još je setup.

idempotentnost, ponavljanja i novac API incident tjedna: nedostak idempotentnosti je zamrzavanje, a ne oluja pono… rezervacija prepaid salda prije prvog terećenja.

Sažetak IOSOR

Radite: prvi živi tjedan vodite na production ključu, potpisanom webhooku i jednom prepaid holdu vidljivom u ledgeru.

Ne radite: stavljati sandbox token na živi promet niti primati nepotpisani callback kao dovoljan za pilot.

Je li vam ovaj vodič pomogao?

Povezani vodiči