ඇමෙරිකානු FDA විසින් ප්රකාශ කරන recall (ආපදා) දත්ත ලබා ගැනීමට openFDA Enforcement API බහුලව භාවිතා වේ. නමුත් නවතම පරීක්ෂණයක් අනුව, මෙම API එකේ අඩුපාඩු කිහිපයක් පෙනී ඇත, ඒවා නිවැරදිව හඳුනාගෙන නොගත් පසු, සංවර්ධකයින් වැරදි තොරතුරු ලබා ගත හැකිය.
API එකේ හතරක්ම recall‑ශෛලී එන්ඩ්පොයින්ට් තිබේ: drug, device, food, සහ device/recall. පළමු ත්රිත්වය (drug, device, food) එකම schema එක භාවිතා කරන අතර device/recall එක වෙනත් schema එකක් පෙන්වයි. එම නිසා, අවශ්ය classification (Class I) සොයන විට වැරදි එන්ඩ්පොයින්ට් තෝරාගත්හොත්, classification ක්ෂේත්ර නොමැතිව 404 දෝෂයක් ලැබේ.
ඉතා වැදගත් ගැටලුවක් නම් OR ක්රියාකාරකමයි. query එකේ parentheses නොමැතිව search=classification:"Class I" OR state:"CA" ලෙස ලියද්දී, පද්ධතිය අවසන් කොන්දේසිය පමණක් ගනී. එම නිසා CA රාජ්යයේ recall ගණනක් පමණක් ලැබෙයි, Class I එකේ ගණන අතුරුදහන් වේ. මෙම වැරදි දෝෂයක් 404 හෝ 200 ප්රතිචාරයක් දෙන අතර, පණිවිඩයේ විස්තර (error.details) පමණක් පරීක්ෂා කළහොත් පමණක් හඳුනාගත හැකිය.
ශ්රී ලංකාවට ඇති වැදගත්කම
- ඉගෙනුම් වශයෙන්: සිසුන්ට API query syntax, encoding, pagination වැනි නියමයන් ගැඹුරු වශයෙන් අවබෝධ කරගත හැකිය.
- සංවර්ධකයින්ට: වැරදි endpoint තෝරා ගැනීමෙන් හෝ OR ගැටලුවෙන් පසු ලැබෙන වැරදි දත්ත නිසා පද්ධති අසාර්ථක වීම වැළැක්විය හැක.
- ව්යාපාරිකයන්ට: FDA recall දත්ත නිවැරදිව භාවිතා කරමින් නිෂ්පාදන ආරක්ෂාව, අනුකූලතා පරීක්ෂණ, සහ ගනුදෙනුකරු විශ්වාසය වැඩි කරගත හැක.
අවසන් වශයෙන්, API භාවිතා කරන සැමෝට parentheses භාවිතය, + ලකුණේ අර්ථය, සහ 1,000 පමණම limit/skip සීමාව ගැන අවධානයෙන් සිටීමට අවශ්යයි. එසේ නොකළහොත්, 30,000 කට අධික recall ලැයිස්තුවක් පවා අඩු කරගත හැකිය.
