ඇමරිකානු Consumer Product Safety Commission (CPSC) විසින් ලබා දෙන Recall API එක, වසර 2018 දී නිකුත් කරපු නිල ගොඩනැගිල්ලේ අනුව, Hazard පරාමිතිය සහ pagination වැනි මූලික විශේෂතා අඩංගු බව කියලා තිබුණා. නමුත් අද දින එය පරීක්ෂා කළ විට, ?RecallTitle=stroller&Hazard=pinch වැනි උදාහරණයක් දීලත්, ප්රතිඵලයක් ලැබෙන්නේ නෑ.
API එකට කිසිදු authentication, API key, registration අවශ්ය නොවේ. එහි default response format XML වන අතර format=json යොදා ගැනීමෙන් JSON ලබා ගත හැක. එය CORS අනුමැතිය ඇති නිසා බ්රවුසරයෙන් JavaScript භාවිතයෙන්ම ඇමතුම් කළ හැක. 12 ක්රමවේදික ඇමතුම් 200 HTTP status code එකක් ලබා දුන්නාත්, ප්රතිඵලය වැරදියි – Hazard filter එක සම්පූර්ණයෙන්ම බිඳී ඇත.
වැඩිදුරටත්, limit, page, offset වැනි pagination පරාමිතීන් කිසිදු බලපෑමක් නොකරයි. සම්පූර්ණ දත්ත ගොනුව (1973‑2026) 0.44 තත්පරයකින් ගොඩක් බාගත කළ හැක, ඒත් 9,905 ලේඛන පමණක් ඇතුළත් JSON එකේ pagination තොරතුරු නැත. එමනිසා, සංවර්ධකයන්ට සියලුම ලේඛන එකවර බාගත කර, ස්ථානීයව filter කිරීමක් කරගත යුතුය.
Hazard filter එකේ ගැටළුව, server‑side හි HazardType සහ HazardTypeID හි හිස් string එකක් තිබීම නිසා සිදුවේ. Hazard Name පුරවා තිබුනද, filter එක එම ගුණය නොබලයි. ඒ අනුව UPC සහ ManufacturerCountry වැනි තවත් පරාමිතීන්ද සමාන ලෙස අසාර්ථක වේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ තාක්ෂණ අධ්යයන ශිෂ්යයන්, API පරිච්ඡේදන, දත්ත විශ්ලේෂණ, සහ වෙබ් සේවා නිර්මාණය පිළිබඳ අත්දැකීම් ලබා ගැනීමට මේ API එක උදව් විය හැක. නමුත් pagination නොමැතිව, සම්පූර්ණ dataset එකක් බාගත කිරීම මතකය සහ bandwidth සම්බන්ධයෙන් බරපතළ වේ. එබැවින්, ශ්රී ලංකාවේ startups සහ SMEs, මෙම API එක භාවිතා කරන විට, local caching සහ date‑window filtering වැනි ක්රම භාවිතා කර, අවශ්ය දත්ත පමණක් ලබාගත යුතුය.
එමෙන්ම, CPSC API ගැටළුව දැන ගැනීම, ශ්රී ලංකාවේ API testing, error handling, සහ documentation audit කිරීමේ නව පදනමක් සපයයි. දේශීය සංවර්ධකයන්ට, අසාර්ථක පරාමිතීන් හඳුනාගැනීමට automated tests ලිවීම, සහ fallback mechanisms (උදා: local filtering) සකස් කිරීමේ හැකියාව වැඩිදියුණු කරයි.
අවසන් වශයෙන්, CPSC Recall API එකේ අඩුපාඩු නිසා, නිවැරදි දත්ත ලබා ගැනීමට සංවර්ධකයන්ට අමතර කාර්යයන් සිදු කළ යුතුය. මෙය තාක්ෂණික පරිසරයේ API reliability සහ data quality ගැන අවධානයක් යොමු කිරීමට හොඳ අවස්ථාවක්.
