ඇප් එකක් මගින් ඊමේල්, කැලන්ඩරය හෝ සම්බන්ධතා පද්ධතියක් කියවීමට පෙර, පරිශීලකයාගේ අනුමැතිය අවශ්යයි. ඒ අනුමැතිය ලබා ගැනීමට OAuth හස්තකාලයක් භාවිතා කරන අතර, redirect URI, scopes, token exchange, refresh token වැනි තත්වයන් නිවැරදිව සැකසීම කට්ටලයක් වගේ පෙනේ. Nylas විසින් ලබා දෙන Hosted OAuth සේවාව මේ සම්පූර්ණ නර්තනය ඔබ වෙනුවෙන් කළමනාකරණය කරයි – ඔබ පරිශීලකයාට අනුමත කිරීමේ URL එකක් යවා, ඔහුගේ provider (Google, Microsoft ආදී) තුළ අනුමැතිය ලබාගෙන, ඉන්පසු grant එකක් ලබා ගත හැක.
මෙම ලිපියේදී Nylas API සමඟ Hosted OAuth ක්රියාවලිය කෙළින්ම පියවරෙන් පියවර විස්තර කරමු. මුලින්ම ඔබේ backend එකේ /v3/connect/auth endpoint එකට client_id, redirect_uri, response_type=code, provider, login_hint වැනි query parameters එක් කර URL එකක් සකස් කර පරිශීලකයාගේ බ්රවුසරයට redirect කරයි. මෙහිදී optional state පරාමිතිය CSRF ආරක්ෂාවට, access_type=offline පරාමිතිය refresh token එකක් ලබා ගැනීමට භාවිතා වේ.
පරිශීලකයා අනුමත කිරීමෙන් පසු provider එක redirect_uri වෙත ?code= පරාමිතිය සමඟ යවයි. ඔබේ server එක එම code එක Nylas හි /v3/connect/token endpoint වෙත POST කර, client_id, client_secret (Nylas API key), redirect_uri, grant_type=authorization_code, code වැනි දත්ත සමඟ token exchange සිදු කරයි. ප්රතිචාරය grant_id, connected email, access_token සහ (offline access ඉල්ලා ඇත්නම්) refresh token එකක් ලබා දෙයි.
ශ්රී ලංකාවට ඇති වැදගත්කම
- ඩිවෙලොපර්ලාට – OAuth සංකීර්ණතා Nylas විසින් කළමනාකරණය කර ගැනීම නිසා, ලාංකීය start‑ups සහ freelance developers ලාගේ backend කේතය කෙටි කර, නිෂ්පාදන වේගයෙන් ගත හැක.
- ව්යාපාරිකයන්ට – ගනුදෙනුකරුවන්ගේ ඊමේල් සහ කැලන්ඩරය සමඟ සම්බන්ධ වීම ඉතාමත් පහසු වේ, ඒත් data privacy compliance රැක ගැනීමට Nylas හි secure token management උපකාරී වේ.
- සිසුන්ට – OAuth 2.0 ප්රොටෝකෝලය, token lifecycle, refresh token වැනි concepts practical project එකකින් අත්හදා බලන්න ලැබේ, එය cloud API integration කුසලතා වර්ධනයට හොඳ පාඩමක්.
සාරාංශයෙන්, Nylas Hosted OAuth භාවිතා කිරීමෙන් ඔබේ ඇප් එකේ email, calendar, contacts API සම්බන්ධතා සැකසීමේ කාර්යබහුලතාවය අඩු කර, security best practices අනුගමනය කර, Sri Lankan developers, businesses, students ලාට තාක්ෂණික වාසියක් ලබා දේ.
ඔබේ ඊමේල් ඇප් එක හෝ SaaS සේවාවක් Nylas Hosted OAuth සමඟ සම්බන්ධ කර, ඉක්මනින් production-ready solution එකක් ගොඩනගන්න.
