openFDA වෙතින් ලබාගත හැකි adverse event (අනතුරු වාර්තා) දත්ත සමුදාය, නව සංවර්ධකයන්ට විශාල තොරතුරු ගබඩායක් ලෙස පෙනේ. නමුත් skip පරාමිතිය 25,000 කට වැඩි කළහොත් "BAD_REQUEST" දෝෂයක් දැනේ. මේ නිසා බොහෝ අය රෙකෝඩ් ගණන අඩු වෙලා, දිනපතා ක්රොන් වැඩ නොකරයි.
මෙම ගැටළුවට විසඳුමක් සොයා ගැනීමට, ලේඛකයා search_after කර්සරය භාවිතා කරමින් Link ශීර්ෂකයේ "next" සබැඳිය අනුගමනය කළා. මෙය skip සීමාව ඉක්මවා, 999 පමණ limit එකක් සමඟ 31,968 වාර්තා 32 පිටු පුරා ලබාගත හැකි වුණා. ඒත් skip=5 වැනි නො-ශූන්ය skip එකක් යොදාගත් විට, next‑link හි cursor අහෝසි වී, 25,000 ගොඩක් වැටුප් බිඳී යන බව සොයාගන්නා ලදි.
වැදගත් කරුණක් නම්, openFDA ලේඛන වල skip සහ search_after එකතුව භාවිතා නොකළ යුතුය. skip=0 (හෝ අක්රිය) තත්ත්වයේ search_after cursor නිවැරදිව වැඩ කරයි. limit=999 දක්වා පමණක් API key නොමැතිව භාවිතා කළ හැකි අතර, limit=1000 හෝ ඊට වැඩි කළහොත් 403 දෝෂයක් "API_KEY_MISSING" ලෙස පෙන්වයි.
දෝෂ පණිවුඩයන් පිළිබඳ විස්තර:
- 400 – skip > 25,000 හෝ skip සහ search_after එකට එකතු කිරීම.
- 403 – limit ≥ 1000 යෙදුම් (key නැති විට) හෝ දිනපතා quota ඉක්මවීම.
- 404 – ගැළපීමක් නොමැතිව, දෝෂයක් නොවේ.
- 500 – ඉල්ලීමේ දෝෂයක්, සමාන ක්ෂේත්රයේ count= පරික්ෂා කිරීමෙන් විසඳිය හැක.
අවසර ලැබූ අඩු request rate (240/min, 1,000/day) මත, සංවර්ධකයන්ට තමන්ගේ code එකේ retry, back‑off වැනි මාර්ගෝපදේශයන් ඇතුළත් කර ගැනීම අත්යවශ්ය වේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ දවස්පතා ආරෝග්ය තොරතුරු විශ්ලේෂණය, ඖෂධ ආරක්ෂාව, AI‑චලිත නිරීක්ෂණ පද්ධති නිර්මාණය සඳහා openFDA API එක විශාල ආශ්රිතයක් වේ. සීමා හඳුනා ගැනීමෙන්, දේශීය සංවර්ධකයන්ට:
- ඖෂධ අහිතකර ප්රතික්රියා දත්ත විශ්ලේෂණය කර, රෝගීන්ට ආරක්ෂිත තොරතුරු ලබාදීම.
- Machine Learning මොඩල සඳහා විශාල, නිවැරදි dataset එකක් සකස් කිරීම.
- ආරෝග්ය තොරතුරු පද්ධති සමඟ එකතු කර, ස්ථානීය සෞඛ්ය අංශයන්ට තීරණාත්මක දත්ත සැපයීම.
අදාල පරිදි search_after cursor භාවිතා කරමින්, ශ්රී ලංකාවේ startups, විශ්වවිද්යාල සිසුන්, සහ IT සමාගම්ට API සීමා අධික නොවී, තොරතුරු ගොනු කිරීමේ කාර්යක්ෂමතාව වැඩි කරගත හැක.
අවසානයේ, openFDA API එකේ paging සීමා හඳුනාගෙන, නිවැරදිව cursor‑based pagination භාවිතා කිරීම, ලොව පුරා data‑driven health tech ක්ෂේත්රයට අත්යවශ්ය පියවරක් වේ.
