ඔබේ කණ්ඩායමට හමුවක් ගන්න උදව්වක් අවශ්යද? කාලය ගණනට ගැලපෙන්නේ කවදද කියලා සොයාගන්නා කාර්යය සෑම වරක්ම ගැටළුවක් වගේම පෙනේ. Nylas විසින් සපයන Availability API ඔබට ඒ ගැටළුවක් කෙළින්ම විසඳා දෙනවා – කේතයක් ලියලා කාලය ගණනට ගැලපෙන අවස්ථා ලැබීමට අවශ්ය ලොජික් එකම ලියන්නෙත් නෑ.
මෙම ලිපියෙන් Nylas Calendar API එකේ free/busy හා availability දෙකේ වෙනස පැහැදිලි කරමින්, CLI (Command Line Interface) භාවිතයෙන් කෙටි පියවර වලින් කවුරුන්ට කවදා නිදහස්ද කියා පරීක්ෂා කරන ආකාරයද පෙන්වයි. ඔබට API අරගෙන HTTP POST අයදුම්පතක් එවන්න හෝ ටර්මිනලයේ nylas calendar availability check කමාන්ඩ් එක භාවිතා කරලා තත්ක්ෂණික විස්තර නොදැන, "අද හෙට කවදා හමුවෙන්න පුළුවන්ද" කියලා දැනගත හැක.
free/busy එනම් එක් එක් පරිශීලකයාගේ "බිසි" කාල සටහන් ලබා දෙන endpoint එකයි. එය ඔබට Unix timestamp ආකාරයේ start_time සහ end_time දෙකක්, සහ ඊමේල් ලැයිස්තුවක් යැවීමට අවශ්ය වේ. ප්රතිඵලයෙහි time_slots අරය තුළ ඒ අයගේ බිසි කාල පරාස පෙන්වයි. නමුත් මෙහි වැදගත් කරුණක් – API එක 200 OK status එකක් දෙන්නේත්, ඕනෑම එකක් resolve නොවූ විට time_slots null වශයෙන් ආපසු එනවා. ඒ නිසා ඔබේ කේතයේ ඒ අගය පරීක්ෂා කරලා පසුදා අගයක් භාවිතා කරන්න.
දෙවන පිළිවෙල availability endpoint එක. මෙහිදී ඔබට මීටර් එක (meeting duration) සහ වින්ඩෝ එක (search window) දීලා, එම කාල පරාසය තුළ සියලු පාර්ශවිකයන්ට ගැලපෙන කාල පටුනක් (slot) ලැබේ. ඔබට "සියලුම කණ්ඩායමට ගැලපෙන 30 මිනිත්තු කාලයක්" කියලා ඉල්ලීමක් කරලා, Nylas ඒ කාල පටුන ඔබට සකස් කර දෙයි. මෙය slot ගණනය කිරීමේ බර ඔබට නොදෙයි – API එකම එය කරලා ඔබට ලැයිස්තුවක් ලබා දෙයි.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තාක්ෂණික ආයතන, startup සමාගම්, විශ්වවිද්යාල සිසුන් සහ ස්වයංක්රීය සේවා සපයන කේතකරුවන්ට මෙම API එක විශාල වාසියක් ලබා දේ. පළමු වරට, free/busy සහ availability අතර තේරීමේ වැරදි නිසා කේතයේ අමතර ලොජික් ලියන අවශ්යතාව අඩුවේ. දෙවැනි වරට, CLI උපකරණය භාවිතා කරලා තත්කාලික පරීක්ෂණයක් කරගත හැකි බැවින්, දැනටමත් නිර්මාණය කරන පද්ධතියේ සමීපයෙන් පරීක්ෂා කරගැනීමට හැකියාව ලැබේ.
ඉතින්, ශ්රී ලංකාවේ මෘදුකාංග සංවර්ධකයන්ට වැඩි කාර්යක්ෂමතාවයක්, වේගවත් නිෂ්පාදන කාලයක්, සහ ගෝලීය API ප්රධානිකත්වයක් ලබා දීමෙන් තරඟකාරීත්වය වැඩි වේ. ඒ වගේම, දේශීය ව්යාපාරිකයින්ට පාරිභෝගික හමුවීම්, ඇප්පලිකේෂන් ඇතුළත් කාල සටහන් කළමනාකරණය, සහ දුරස්ථ කණ්ඩායම් සම්බන්ධතා සකස් කිරීමේදී පිරිවැය අඩුවීමේ ලාභයක් ලැබේ.
සාරාංශයෙන්, Nylas Availability API එක ඔබේ කේතයට එකතු කිරීමෙන් හමුවීම් සකස් කිරීමේ ගැටළුව ඉක්මනින් විසඳා ගත හැකි අතර, ශ්රී ලංකාවේ තාක්ෂණික පරිසරයට නව නව ප්රවණතා ගෙන එයි.
