කාලගුණ විද්‍යා දෙපාර්තමේන්තුව · ශ්‍රී ලංකාව

පොදු අනතුරු ඇඟවීම් API

ශ්‍රී ලංකාවේ ක්‍රියාත්මක කාලගුණ අනතුරු ඇඟවීම් සිංහල, දෙමළ සහ ඉංග්‍රීසි භාෂාවෙන් ලබා දෙන කියවීම-පමණක් feed එකකි. සජීවී ඒකාබද්ධ කිරීම් සඳහා වෙනස්කම් සොයන endpoint එකක් ද ඇත.

පදනම් URL: was.meteo.gov.lk/apiසත්‍යාපනය: X-API-Key headerඉල්ලීම් 120 / තත්පර 60සියලුම වේලාවන්: ශ්‍රී ලංකා වේලාව (UTC+05:30)

සත්‍යාපනය

සෑම ඉල්ලීමකම HTTP header එකක් ලෙස ඔබේ key එක එවන්න. වලංගු key එකක් නොමැති ඉල්ලීම් 401 Unauthorized ලෙස ප්‍රතිචාර දක්වයි.

header

X-API-Key: YOUR_KEY

වර්තමාන අනතුරු ඇඟවීම්

GET/api/warnings

දැනට ක්‍රියාත්මක සියලුම අනතුරු ඇඟවීම් ලබා දෙයි. එක් භාෂාවක් පමණක් ලබා ගැනීමට ?lang= එක් කරන්න.

උත්සාහ කරන්න

curl

curl -H "X-API-Key: YOUR_KEY" \
  "https://was.meteo.gov.lk/api/warnings"

response (trimmed)

[
  {
    "id": "a5c33756-...",
    "day_key": "today",
    "name": "Lightning",
    "level": "red",
    "valid_from": "2026-09-30T12:00:00+05:30",
    "valid_to": "2026-09-30T23:00:00+05:30",
    "summary_en": "Thundershowers accompanied...",
    "summary_si": "අකුණු සහිත ගිගුරුම්...",
    "summary_ta": "இடி மின்னலுடன்...",
    "areas_en": ["Ampara", "Batticaloa", ...],
    "published_at": "2026-09-30T09:07:49+05:30"
  }
]

අනෙකුත් query parameters

Param	Values	Purpose
day	today · tomorrow · dayAfter	filter to one day
limit	1–200 (default 50)	max results
include_expired	true · false	include warnings past valid_to

වෙනස්කම් සඳහා විමසන්න

GET/api/warnings/changes

ඒකාබද්ධ කිරීමට නිර්දේශිත ක්‍රමය. සෑම විටම සියල්ල නැවත ලබා ගැනීම වෙනුවට, කාල පරතරයකින් (තත්පර 60ක් සුදුසුය) විමසන්න. ඉහත lang parameter එකම භාවිත කළ හැක.

මෙය වෙන් වූ ඉල්ලීම් දෙකක් නොවේ — එකම ඉල්ලීම, කාලසටහනකට අනුව, සදහටම නැවත කරයි. සෑම ප්‍රතිචාරයක්ම ඊළඟට යැවිය යුත්තේ කුමක්දැයි නිශ්චිතව පවසයි.

the loop

# 1. Start with any since value — today's date is fine.
curl -H "X-API-Key: YOUR_KEY" \
  "https://was.meteo.gov.lk/api/warnings/changes?since=2026-09-30"

# -> { "since": "2026-09-30T09:07:49+05:30", "warnings": [...] }

# 2. Wait ~60s, then call again using the "since" THIS response gave you.
curl -H "X-API-Key: YOUR_KEY" \
  --data-urlencode "since=2026-09-30T09:07:49+05:30" \
  -G "https://was.meteo.gov.lk/api/warnings/changes"

# -> { "since": "2026-09-30T09:08:52+05:30", "warnings": [...] }

# 3. Wait ~60s, call again with THAT since. Repeat forever.

1. පළමු ඉල්ලීම

ආරම්භක since අගයක් තෝරන්න.

2. රැඳී සිට, නැවත කරන්න

තත්පර 60ක් පමණ රැඳී, අවසාන ප්‍රතිචාරයෙන් ලැබුණු since අගය භාවිත කර නැවත ඉල්ලන්න.

3. දිගටම කරගෙන යන්න

සෑම ප්‍රතිචාරයක්ම නව since අගයක් ලබා දෙයි. එය ඊළඟ ඉල්ලීම සඳහා, සදහටම භාවිත කරන්න.

පෙර ප්‍රතිචාරයෙන් ලැබුණු since අගයම භාවිත කරන්න — ඔබම නිර්මාණය නොකරන්න.

වේලා සලකුණු සහ since

මෙම API එකෙන් ලැබෙන සෑම වේලා සලකුණක්ම ශ්‍රී ලංකා වේලාවයි (UTC+05:30), සෑම විටම පැහැදිලි offset එකක් සමඟින් — කිසි විටෙකත් හිස් UTC ලෙස නොවේ.

ඔබ එවන්නේ	අපි එය කියවන්නේ
2026-09-30T14:30:00+05:30	14:30 Sri Lanka time
2026-09-30T09:00:00Z	09:00 UTC — same instant, also fine
2026-09-30T09:00:00 (no offset)	assumed Sri Lanka time
2026-09-30 (date only)	midnight Sri Lanka time

සරලම ක්‍රමය: ඔබේ පෙර ඉල්ලීමෙන් අප ලබා දුන් since අගයම නැවත එවන්න. එයට දැනටමත් නිවැරදි offset එක ඇති බැවින් ඔබම එකක් සෑදිය යුතු නැත.

CAP අනතුරු ඇඟවීම් සහ RSS feed

ක්‍රියාත්මක අනතුරු ඇඟවීම්වල සම්මත CAP 1.2 XML feed එකක් සහ ඒවා ලැයිස්තුගත කරන RSS feed එකක්, දෙකම සිංහල, දෙමළ සහ ඉංග්‍රීසි භාෂාවෙන්. දෙකටම API key අවශ්‍ය නොවේ — rate limit එකක් පමණි.

RSS feed

GET/cap/rss.xml

GET/cap/{lang}/rss.xml

curl

curl "https://was.meteo.gov.lk/cap/si/rss.xml"

තනි CAP අනතුරු ඇඟවීමක් (XML)

GET/cap/{capId}

GET/cap/{lang}/{capId}

curl

curl "https://was.meteo.gov.lk/cap/ta/a5c33756-5008-44fe-bca0-79e43a61c32b"

භාෂා විකල්ප: {lang} වෙනුවට en, si හෝ ta යොදන්න. එය හිස්ව තැබුවහොත් ඉංග්‍රීසි පෙරනිමිය ලෙස භාවිත වේ.

දෝෂ

තත්ත්වය	අර්ථය
401	missing or invalid X-API-Key
400	bad or missing since, or an invalid lang value
429	rate limit exceeded (120 requests / 60s)