API ලෙස ශ්රී ලංකා වෙළඳ දත්ත
නිදහස් සහ පොදු JSON අන්ත ලක්ෂ්ය දෙකක්: ශ්රී ලංකාවේ වාර්ෂික අපනයන දත්ත, සහ කොළඹ වරායෙන් නිකුත් වන භාණ්ඩ පිළිබඳ දෛනික කියවීමක්. යතුරු නොමැත, ලියාපදිංචිය නොමැත, ගාස්තු ශ්රේණිය නොමැත. ඒවා ඩෑෂ්බෝඩ්, ආකෘති, හෝ පැතුරුම්පතකදී භාවිත කරන්න.
මෙය කුමක්ද
අපගේ ම Trade Desk සඳහා රැකබලා ගන්නා දත්ත කට්ටල දෙකක් අපි ප්රකාශ කරමු. වාර්ෂික දත්ත ශ්රී ලංකාවේ අපනයන සංඛ්යාලේඛනවල ශෛලීකෘත සමාහාරයකි. සජීවී ෆීඩ් කොළඹ වරායේ නෞකා නැව්ගාල් ගැනීමේ වැඩසටහනෙන් සෑම උදෑසනකම ගොඩ නගා ගනු ලැබේ; ඒ නිසා, දෙවර්ෂයකට පෙර ගිය ප්රමාණ ගැන නොව, මෙම සතිය ඇත්ත වශයෙන් ගෙනයනු ලබන දේ ගැන ඔබට කියයි.
දෙකම නොමිලේ ලබා දෙන අතර සත්යාපනයක් අවශ්ය නොවේ. IP ලිපිනයකට පැයකට requests 120 ක් ලෙස ප්රමාණ සීමාව නියම කර ඇත — එය dashboard එකකට අවශ්ය ප්රමාණයට වඩා බෙහෙවින් වැඩි අතර scraper එකකට ඉල්ලෙන ප්රමාණයට වඩා බෙහෙවින් අඩු ය.
ඕනෑම දෙයක් ප්රස්තාරගත කිරීමට පෙර මෙය කියවන්න. සජීවී දත්ත ප්රවාහය වන්නේ වරාය බැහැර ප්රවාහ: සෑම නෞකාවකම ඊළඟ නැව්ගාල. කොළඹ නැවත ප්රේෂණ මධ්යස්ථානයකි, ඒ නිසා මෙය නොවේ භාණ්ඩ අවසාන වශයෙන් ළඟා වන ස්ථානය වේ; ශ්රී ලංකාවේ අපනයන ගමනාන්ත ලැයිස්තුවක් නොවේ. ඇත්ත අපනයන වෙළඳපොළ ගැන, පහත වාර්ෂික endpoint භාවිත කරන්න. දත්ත තුළදීද අපි ඒ ලෙසම ලේබල් කරමු; ඔබ විශාල සංඛ්යාවක් ලබා ගැනීමට වඩා නිවැරදිව ක්රියා කිරීමට අපි කැමැත්තෙමු.
Endpoints
GET/wp-json/sle/v1/export-data
ශ්රී ලංකාවේ වාර්ෂික අපනයන දත්ත: මුළු අගය, ඛණ්ඩාංක සහිත විශාලතම ගමනාන්ත වෙළඳපොළ දහය, සහ සෑම කණ්ඩායමකම ඉහළ ම වෙළඳපොළ තුනක් සහිත භාණ්ඩ කණ්ඩායම් හය. UN Comtrade ආශ්රයෙන් වාර්ෂිකව අතින් යාවත්කාලීන කෙරේ. පැය 12ක් කෑෂ් කෙරේ.
| ක්ෂේත්රය | එය දරන දේ |
|---|---|
| data.year | ප්රතිචාරයේ සෑම අගයකටම අදාළ වාර්තා වර්ෂය. |
| data.total_usd_m | සම්පූර්ණ අපනයන, USD මිලියන. |
| data.markets[] | ගමනාන්ත වෙළඳපොළ: නම, ISO කේතය, අක්ෂාංශ, දේශාංශ, USD මිලියන වලින් වටිනාකම. |
| data.commodities[] | භාණ්ඩ කාණ්ඩ: නම, වටිනාකම, සහ ප්රමුඛ වෙළඳපොළ තුන හා ඒවායේ කොටස්. |
| meta.attribution | අනිවාර්ය ආරෝපණ පෙළ. අංකලේඛ ප්රදර්ශනය කරන සෑම තැනකම එය ඇතුළත් කරන්න. |
| meta.cadence | මූල ගොනුව යාවත්කාලීන වන සංඛ්යාතය. |
curl https://srilankaexport.com/wp-json/sle/v1/export-dataGET/wp-json/sle/v1/export-data/live
ශ්රී ලංකා වරාය අධිකාරිය සහ Colombo International Container Terminals ගාල ගැනීමේ වැඩසටහන් ආශ්රයෙන් දිනපතා ප්රතිනිර්මාණය කරනු ලබන, කොළඹ වරායෙන් පිටවන කන්ටේනර් ගමනාගමනය. විනාඩි 30ක් සංචිතගත කෙරේ.
| ක්ෂේත්රය | එය දරන දේ |
|---|---|
| snapshot_utc | මෙම ස්නැප්ෂොට් ගොඩනගන ලද වේලාව. දත්ත චලනය වූවාද යන්න HTTP දිනය නොව මෙය භාවිතයෙන් තීරණය කරන්න. |
| window | ගණනය ආවරණය කරන චලන කාල කවුළුව — එහි ආරම්භය, අවසානය සහ දිනවල දිග. |
| vessel_calls | කාල කවුළුව තුළ නෞකා පැමිණීම් ගණන. |
| export_containers | පැටවූ බහාලුම් ගණන. මෙය අපනයන සංඥාවයි. |
| import_containers | බෑ කරන ලද බහාලුම් ගණන. |
| top_lines[] / top_services[] | පැටවූ ප්රමාණය අනුව නැව් සමාගම් සහ සේවා. |
| upcoming_departures[] | යාත්රා කිරීමට නියමිත නෞකා — ලයින්, සේවා, ETA සහ භාරය සමඟ. |
| flows[] | ගමනාන්ත කලාපය අනුව පරිමාව. ඉහත අනතුරු ඇඟවීම බලන්න: අවසාන ගමනාන්තය නොව ඊළඟ නැවතුම් වරාය. |
| meta.stale | ස්නැප්ෂොට් එක පැය 36 ට වඩා පැරණිව ඇති විට True වේ. සංඛ්යාවලට විශ්වාස කිරීමට පෙර මෙය පරීක්ෂා කරන්න. |
curl https://srilankaexport.com/wp-json/sle/v1/export-data/liveමූලාශ්ර සහ ඔබ අප වෙත ගෙවිය යුතු මුදල්
වාර්ෂික සංඛ්යාලේඛන ලබා ගන්නා ලද්දේ UN Comtrade (United Nations Statistics Division) වෙතිනි. මේවා සම්පූර්ණ දත්ත කට්ටලය නොව, තෝරාගත් සාරාංශයකි. සජීවී දත්ත ප්රභවය වන්නේ ශ්රී ලංකා වරාය අධිකාරිය සහ Colombo International Container Terminals, පොදු සහ සත්යාපනය නොකළ දෙකටම.
සෑම ප්රතිචාරයකම attribution string එකක් ඇතුළත් වේ meta.attribution. ඔබ ඒ අංකයන් ප්රකාශ කරන්නේ නම්, attribution string ද ඒවා සමඟ ප්රකාශ කරන්න. ඊට ඔබ්බෙන් අත්සන් කළ යුතු බලපත්රයක් නොමැති අතර ගෙවිය යුතු කිසිවක් ද නොමැත.
ඔබ නිර්මාණය කරන දෙය මෙයට වඩා වැඩිදේ ඉල්ලා සිටින්නේ නම්, හෝ වත්මන් කවුළුවට වඩා දිගු ඉතිහාසයක් අවශ්ය නම්, ඔබට අවශ්ය දේ අපට දන්වන්න. live endpoint හරහා ලබාදෙනවාට වඩා ඈතට දිවෙන port feed හි දෛනික ලේඛනාගාරයක් අපි නඩත්තු කරනු ලබමු.
මෙය යොදාගෙන යමක් නිර්මාණය කරනවාද?
අපි දැන ගැනීමට කැමතියි. ඔබට කිසිදු වියදමක් නොමැති අතර, කුමන දත්ත නඩත්තු කිරීමට වටිනවාද යන්න ද අපට පැහැදිලි වේ.
අපගේ Trade Desk ට දන්වන්න →