ඔබගේ Clio ඒකාබද්ධකරණය 401 පණිවුඩයක් දක්වලා, ඒක හේතුව හොයන්න යනවා නම්, පළමු පියවර කේතය පරීක්ෂා කිරීම නොව, ඔබ භාවිතා කරන Clioගේ OAuth වර්ගය හඳුනා ගැනීමයි. දෙකම වෙනස් නීති රීති අඩංගු නිසා, අන්තර්ජාලයේ බොහෝ උපදෙස් කුමන පද්ධතිය ගැන කියන්නේ කියලා පැහැදිලි නැත.
Clio Manage vs Clio Platform
- Clio Manage – පරණ පද්ධතිය. OAuth:
app.clio.com/oauth, API:app.clio.com/api/v4 - Clio Platform – නව පද්ධතිය (Grow, lead inbox ආදී). OAuth:
auth.api.clio.com/oauth, API:api.clio.com
මෙම දෙකේ ප්රධාන වෙනස ටෝකන් ගාණය, නවීකරණ (refresh) ක්රම, හා ප්රදේශ (region) සම්බන්ධීකරණයයි.
ටෝකන් ආයුෂය හා නවීකරණය
Manage පද්ධතියේ access token එක 30 දින (2,592,000 සෙකන්ඩ්) පමණක් පවතී, නමුත් refresh token එක කාලය නොමැති, නිතර වෙනස් නොවෙයි. Platform පද්ධතියේ access token එක 24 පැය (86,400 සෙකන්ඩ්) පමණක්, සහ refresh token එක සෑම නවීකරණයකට පසුම නව token එකක් ලබා දී, පැරණිය අක්රිය කරයි. ඔබ නව refresh token එක සුරකින්න අමතක කරන්නේ නම්, ඊළඟ ඇමතුමට පරණ token එක භාවිතා කර 401 දෝෂයට මුහුණ දේ.
ප්රදේශ (Region) ගැටලුව
Clio ලෝකය තුළ US, EU, Canada, Australia වැනි නාගරික හතරක් පවත්වා ඇත. එක් ප්රදේශයකින් ලබාගත් token එක වෙනත් ප්රදේශයේ API සමඟ භාවිතා කළ නොහැක. ඔබ tutorial එකේ app.clio.com (US) භාවිතා කරලා, පාරිභෝගිකයා Australian instance එකේ ලොග්‑ඉන් වුනා නම්, token එක වැරදි සේවාදායකයට යැවීම නිසා 401 දෝෂයක් ලැබේ. එක් එක් ප්රදේශයට වෙනම developer application (client_id, client_secret) ලියාපදිංචි කළ යුතුය.
අක්රිය කිරීම (Revocation) පිළිබඳ සැලකිල්ල
පරිශීලකයා Clio තුළ ඔබේ යෙදුම අක්රිය (disconnect) කරන විට, ඒ පරිශීලකයාගේ access token සහ refresh token දෙකම අහෝසි වේ. ඔබම revoke API භාවිතා කරන්නේ access token එක පමණක් අහෝසි කරන අතර, පරිශීලකයාගේ ක්රියාවලියෙන් එන අහෝසි කිරීම වැඩි පරාසයක් ගෙන එයි. Clio ඔබට revocation callback URL එකක් සකස් කර දෙයි; එම URL එකට client_id, user_id, access_token යන තොරතුරු POST කරයි, එමඟින් ඔබට token අහෝසි වීමක් වහාම දැනගත හැක.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ බොහෝ startup, law‑tech, සහ SaaS සංවර්ධකයින් Clio API භාවිතා කරමින් නීති සේවා අඩවි හා automation විසඳුම් නිර්මාණය කරති. මේ පද්ධතියේ OAuth විස්තර හොඳින් නොදැනීම නිසා අහඹු 401 දෝෂයන් පණිවුඩයක් ලෙස පෙනෙයි, ඒත් ඇත්තේ token ගාණය, නවීකරණ, ප්රදේශ, හෝ අක්රිය කිරීමේ ගැටලුවක්. නිවැරදි region URL, නව refresh token සුරැකුම්, සහ revocation callback සකස් කිරීම මඟින් සංවර්ධකයින්ට පහසුවෙන් ස්ථාවර integration එකක් ගොඩනැගීමට, අඩු downtime එකක් ලබාගැනීමට, හා ගනුදෙනුකරුවන්ට වඩා විශ්වාසදායක සේවාවක් ලබාදීමට හැකියාව ලැබේ.
අවසන් වශයෙන්, Clio token ගැටලුවට මුහුණ දුන් විට, පළමු පියවර ඔබේ OAuth වර්ගය, token lifetime, region, සහ revocation සැකසුම් පරීක්ෂා කිරීමයි. එම පදනම මත ඔබේ කේතය වෙනස් කිරීමේ අවශ්යතාවය පැහැදිලි වේ.
