IOSOR జ్ఞానం
సెండ్ API ఐడంపొటెన్సీ: డూప్లికేట్లు, రీట్రైలు మరియు డబ్బు
ప్రీపెయిడ్ సెండ్ API డెవలపర్ గైడ్ — ఐడంపొటెన్సీ కీలు, సురక్షిత రీట్రైలు, డూప్లికేట్ నివారణ, లెడ్జర్-స్నేహపూర్వక అనుబంధం; ఇంజినీరింగ్ తప్పులు ఆర్థిక సంఘటనలు కాకుండా ఉండేలా.
టైమ్అవుట్లు జరుగుతాయి. లోడ్ బ్యాలన్సర్లు రీట్రై చేస్తాయి. మొబైల్ క్లయింట్లు డబుల్-ట్యాప్ చేస్తాయి. ఐడంపొటెన్సీ లేకుండా "ఒక్కసారి పంపు" ఉత్పత్తి ప్రీపెయిడ్ రెట్టింపు డెబిట్ మరియు డూప్లికేట్ OTP UX అవుతుంది. ఇది వైట్-లేబుల్ ప్రీపెయిడ్ మెసేజింగ్ API ఇంటిగ్రేట్ చేసే ఇంజినీరింగ్ మరియు టెక్నికల్ ప్రొడక్ట్ కోసం — ప్రతి డూప్లికేట్ వాలెట్లో కనిపిస్తుంది. IOSOR డబ్బు-అవగాహన ఇంటిగ్రేషన్లను ఆశిస్తుంది: ప్రామాణీకృత కాల్లు, సరిపోల్చదగిన డెబిట్లు, విదేశీ బ్రాండ్ పేప్లోడ్లను కుమ్మరించని క్లయింట్ లోపాలు. నెలవారీ ప్లాట్ఫారం వినియోగం సుమారు USD 1,000+కి దగ్గరైతే డూప్లికేట్ క్రమశిక్షణ ఐచ్ఛికం కాదు.
డూప్లికేట్లు ఎందుకు డబ్బు సమస్యలవుతాయి
| వైఫల్య మోడ్ | వినియోగదారు చూసేది | వాలెట్ చూసేది |
|---|---|---|
| క్లయింట్ టైమ్అవుట్ + గుడ్డి రీట్రై | రెండు OTP / రెండు అలర్ట్లు | రెండు డెబిట్లు |
| నాన్-ఐడంపొటెంట్ webhook హ్యాండ్లర్ | రెట్టింపు సైడ్ ఎఫెక్ట్లు | విజయంలో గందరగోళం |
| ఆటో-రీట్రైపై యూజర్ రీసెండ్ | చిరాకు వినియోగదారులు | పేరుకున్న యూనిట్లు |
| అనుబంధం లేదు | "విఫలమైంది" టికెట్లు | సరిపోలని లెడ్జర్ అడ్డు వరుసలు |
డెమోలు క్షమిస్తాయి. ప్రొడక్షన్ ఫైనాన్స్ కాదు. ప్రీపెయిడ్ తీవ్రతలో గుడ్డి రీట్రైల వారాంతం లాగ్ ఫుట్నోట్ కాదు, సమన్వయ ప్రాజెక్ట్ అవుతుంది. హ్యాపీ పాత్ మరియు టైమ్అవుట్ మార్గాన్ని అదే డెబిట్ నియమంతో డిజైన్ చేయండి.
రీట్రైలను తట్టుకునే ఐడంపొటెన్సీ కీలు
గంభీరమైన సెండ్ పాత్ క్లయింట్-జనరేటెడ్ కీని అంగీకరిస్తుంది, అది వ్యాపార ఉద్దేశం ప్రతి ప్రత్యేకమైనది, TCP ప్రయత్నం ప్రతి కాదు. ఇది స్పష్టమైన TTL విండోలో రీప్లేలో అదే accepted ఫలితం ఇవ్వాలి. ఇది అదే ఉద్దేశానికి నిశ్శబ్దంగా రెండవ డెబిట్ సృష్టించదు. కీ మెసేజ్ ID మరియు ప్రీపెయిడ్ రిఫరెన్స్ పక్కన లాగ్ అవ్వాలి. ఇది టైమ్అవుట్లు, గేట్వే రీట్రైలు, సపోర్ట్ రీడ్రైవ్లలో పనిచేయాలి.
రీట్రై బడ్జెట్లు vs వినియోగదారు మళ్లీ పంపడం
ఆటోమేటిక్ రీట్రైలకు బడ్జెట్ కావాలి: గరిష్ట ప్రయత్నాలు, బ్యాకాఫ్, మరియు ఏ లోపం తరగతులు రీట్రై చేయదగినవి. వినియోగదారు ప్రారంభించిన రీసెండ్ వేరొక ఉత్పత్తి చర్య, దీనికి సొంత రేటు పరిమితులు మరియు ప్రీపెయిడ్ ఖర్చు ఉంటాయి. రెండింటినీ కలపడం వల్ల అస్థిరమైన నెట్వర్క్ వారాంతపు వాలెట్ ఈవెంట్గా మారుతుంది. రెండింటినీ లో-బ్యాలెన్స్ స్టాప్ మరియు స్పష్టమైన రిజెక్ట్ కారణాలతో జత చేయండి — ఉత్పత్తి మరియు ఫైనాన్స్ ఒకే నిజాన్ని పంచుకోవాలి.
కొనుగోలుదారు / ఇంజినీరింగ్ చెక్లిస్ట్
- డాక్యుమెంట్ చేయబడిన ఐడంపొటెన్సీ కీ సెమాంటిక్స్ మరియు TTL.
- ఒక ఉద్దేశానికి ఒక డెబిట్ను నిరూపించే రీప్లే టెస్ట్.
- ఆటో-రీట్రై బడ్జెట్ను యూజర్ రీసెండ్ లాజిక్ నుండి వేరు చేయడం.
- రిక్వెస్ట్, మెసేజ్ స్టేటస్ మరియు ప్రీపెయిడ్ లెడ్జర్ అంతటా కోరిలేషన్ IDలు.
- నిజమైన కారిడార్లను పరీక్షించే స్టేజింగ్ — మాక్ గ్రీన్ లైట్లు లాంచ్లు కావు.
- సెండ్ క్రెడెన్షియల్స్ కోసం కీ హైజీన్ మరియు లీస్ట్ ప్రివిలేజ్.
- ఒరిజినల్ ఇంటెంట్ కీని కోల్పోకుండా 429 మరియు 503 కోడ్లను హ్యాండిల్ చేయడం.
- అధిక డూప్లికేట్-కీ రిజెక్షన్ రేట్ల కోసం ఆటోమేటెడ్ అలర్ట్లు.
ఎరుపు జెండాలు
- ఐడంపొటెన్సీ కీలు లేకుండా "200 వచ్చే వరకు రీట్రై చేయండి".
- ఐడంపొటెంట్ కాని మరియు సైడ్ ఎఫెక్ట్లను రెండుసార్లు ట్రిగ్గర్ చేసే webhook హ్యాండ్లర్లు.
- లాగ్లు లేదా సపోర్ట్ టికెట్లలో కనిపించే పూర్తి సీక్రెట్ కీలు లేదా అథ్ టోకెన్లు.
- ఎండ్ యూజర్లకు అప్స్ట్రీమ్ బ్రాండ్ పేప్లోడ్లు లేదా ఇంటర్నల్ స్టాక్ ట్రేస్లను చూపించే లోపాలు.
- రీట్రై బడ్జెట్ పరిమితులు లేకపోవడం.
IOSORతో ప్రారంభించండి
పంపే కన్సోల్లో ఐడెంపొటెన్సీ కీతో ఒక OTP పంపండి. టైమ్అవుట్ తర్వాత అదే అభ్యర్థనను మళ్లీ పంపండి. prepaid ledgerలో ఒక debit మాత్రమే ఉండాలి. రెండు అడ్డులు ఉంటే TTLను సరిచేయండి.
- లాంచ్ తర్వాత నిలిచే వెబ్హుక్లు
- పైలట్ నుండి ప్రొడక్షన్కు API రేటు పరిమితులు
- మీరు పంపే ముందు NANP ఓవర్లేలు: ఫైనాన్స్ కోసం డేటా నాణ్యత
IOSOR సారాంశం
చేయండి: ప్రతి పంపును ముందుగా ledger సంఘటనగా చూడండి. కీ వ్యాపార ఉద్దేశానికి ప్రత్యేకం. ఆటో-రీట్రైకి బడ్జెట్ ఉంది. వినియోగదారు మళ్లీ పంపడం వేరే చర్య.
చేయవద్దు: కీ లేకుండా మళ్లీ కొట్టడం. webhook రెండవ దుష్ప్రభావం వద్దు. ఒక ట్యాప్కు రెండు OTPలు డబ్బు లోపం.
ఈ గైడ్ సహాయకరంగా ఉందా?
సంబంధిత గైడ్లు
- స్థానిక పరీక్షలలో DLR లాటెన్సీ మరియు లోపాలను అనుకరించడం
మీ CPaaS ఇంటిగ్రేషన్ను ప్రొడక్షన్కు పంపే ముందు, స్థానికంగా అసమకాలిక డెలివరీ రసీదులను మాక్ చేయడం, DLR లాటెన్సీని నిర్వహించడం మరియు ఎడ్జ్ కేసులను పరీక్షించడం ఎలాగో తెలుసుకోండి.
- పేలోడ్ బ్యాచింగ్ మరియు సింగిల్ రిక్వెస్ట్ త్రూపుట్ మధ్య సమతుల్యత
మీ వైట్-లేబుల్ CPaaS కన్సోల్లో రేట్-లిమిట్ సమ్మతిని కాపాడుకుంటూ, అధిక-వాల్యూమ్ నోటిఫికేషన్ డిస్పాచ్ కోసం API కరెన్సీ వ్యూహాలను ఆప్టిమైజ్ చేయండి.
- ప్లాట్ఫారమ్ భద్రత కోసం మల్టీ-టెనెంట్ API కీ స్క్రీనింగ్ మరియు ఐసోలేషన్
టెనెంట్ ట్రాఫిక్ను వేరు చేయడానికి, క్రాస్-అకౌంట్ సందేశ లీక్లను నివారించడానికి మరియు ఆర్థిక పరిమితులను అమలు చేయడానికి API టోకెన్లను స్కోప్ చేయడం ద్వారా వైట్-లేబల్ CPaaS సబ్-అకౌంట్లను సురక్షితం చేయండి.