ශ්‍රී ලංකාවේ නවතම තාක්ෂණික පුවත් 2026-07-26, Sunday
💻 ක්‍රමලේඛනය · 🕒 කියවීමට විනාඩි 2 · 👁 1

අයිඩම්පොටන්ට් Transaction API නිර්මාණය: මුදල් දෙවරක් ගෙවීම වැලැක්වීමේ නව ක්‍රමය

අයිඩම්පොටන්ට් Transaction API නිර්මාණය: මුදල් දෙවරක් ගෙවීම වැලැක්වීමේ නව ක්‍රමය

ජාලය හරහා ගනුදෙනු කරන වෙලාවේ TCP timeout වීම හේතුවෙන් පාරිභෝගිකයා එකම ඉල්ලීම දෙවරක් යැවීමේ අවදානම වැඩි වෙයි. මේ ආකාරයේ ‘රේස් කොන්ඩිෂන්’ එක මුදල් පද්ධතිවල අතිශය ගැටළුවක්. එය නිවැරදිව පාලනය නොකළහොත් එකම ගනුදෙනුව දෙවරක් සටහන් වීම, අතිරේක ගාස්තු, පාරිභෝගික විශ්වාසය අඩු වීම වැනි ප්‍රතිඵල ලැබේ.

මෙම ගැටළුවට විසඳුමක් ලෙස සංවර්ධකයන් ‘Idempotency Key’ භාවිතා කරමින් අයිඩම්පොටන්ට් API එකක් නිර්මාණය කරන ලදි. ක්‍රියාත්මක වන ආකාරය සරලයි: පාරිභෝගිකයා ඉල්ලීම සමඟ අයිඩම්පොටන්ට් කී එකක් (X) යොදයි. API ගේට්වේ ඒ කී එක Redis cache තුළ SetNX (නව නම්) ක්‍රියාවලියෙන් තබා, එය පවතිනවා නම් 409 Conflict පණිවුඩයක් පල කරයි. නව නම් නම් PostgreSQL දත්ත ගබඩාවට Double‑Entry Transaction එකක් ක්‍රියාත්මක කර, සාර්ථක වීමෙන් පසු Redis හි තත්ත්වය “DONE” බවට වෙනස් කර, ප්‍රතිචාරය සුරකින්නේ.

දත්ත ගබඩාවේද අයිඩම්පොටන්ට් කී එකට UNIQUE සීමාවක් දී ඇත. එමඟින් එකම කී එක දෙවරක් සටහන් වීම අඩු කරයි. Python FastAPI හා Redis භාවිතා කරමින් ලියන ලද කේත උදාහරණයක් මෙහි දැක්වෙයි. Redis හි set(..., nx=True) විකල්පය අඩංගු “Atomic Check‑and‑Set” ක්‍රියාවලිය මඟින් සමකාලීන ඉල්ලීම් එකම කී එකට ප්‍රතික්‍රියා නොලැබෙයි. ගැටළුවක් සිදු වුවහොත් Redis කී එක මකා, පාරිභෝගිකයාට 500 Internal Server Error පණිවුඩයක් දෙනු ලැබේ.

ශ්‍රී ලංකාවට ඇති වැදගත්කම

ශ්‍රී ලංකාවේ fintech, e‑commerce සහ බැංකු සේවාවන් දියුණුවට පත් වෙමින් පවතී. අයිඩම්පොටන්ට් API එක භාවිතා කිරීමෙන් දේශීය සංවර්ධකයන්ට ගනුදෙනු ආරක්ෂිතව, දෙවරක් නොකෙරෙන ආකාරයෙන් සකස් කිරීමේ හැකියාව ලැබේ. ඒ නිසා පාරිභෝගික විශ්වාසය වැඩිවීමත්, අතුරුදන් වූ ගාස්තු හෝ නීතිමය ගැටළු අඩු වීමත් සිදු වේ.

ශ්‍රී ලංකා විශ්වවිද්‍යාල සිසුන්ට මේ තාක්ෂණය අධ්‍යයනය කිරීම, සමාගම් සඳහා මෙය ක්‍රියාත්මක කිරීම නව සේවා නිර්මාණය, ලාභ වැඩි කිරීම සහ දේශීය API පාරිසරිකය තවත් ශක්තිමත් කිරීමේ අවස්ථාවක් වේ. කුඩා ව්‍යාපාරයන්ටත් අඩු වියදමින් ගනුදෙනු ආරක්ෂා කර, තරඟකාරීත්වය වැඩි කර ගත හැකිය.

අවසානයේ, අයිඩම්පොටන්ට් Transaction API එක යනු “දෝෂ රහිත ගනුදෙනු” සලස්වන නවතම පාරිසරිකයක්. එය ගෝලීය මට්ටමේම නොව, ශ්‍රී ලංකාවේ තාක්ෂණික ආර්ථිකයත්, පාරිභෝගික අත්දැකීමත් නව මට්ටමකට ගෙන යාමට සූදානම්.

💡 ඔබේ පද්ධතියට අයිඩම්පොටන්ට් API එකක් එක්කර ආරක්ෂිත ගනුදෙනු සලස්වන්න!
මූලාශ්‍රය මෙම ලිපිය AI මගින් රචිත මුල් සාරාංශයකි. සම්පූර්ණ වාර්තාව කියවන්න:
Dev.to ↗
#API #Idempotency #Fintech #Redis #FastAPI