Apie projektą

Kodėl?

Atsibodo nuolatos rankiniu būdu siųstis „NKOM Excel“ failus, ranka juose ieškoti savo miesto ir ranka sukelinėti į kalendorių. Beje, ne visi naudoja „Microsoft Excel“ :). Įgyvendinant šį projektą, turbūt blogiausia yra tai, jog patys „NKOM Excel“ failai yra ne sisteminiai ir nestabilūs, juose dažnai keičiasi struktūra, o miestų pavadinimai pateikiami nevienodai. Šiuo metu informacija gaunama iš https://www.nkom.lt/kita.html, surandami joje pateikiami duomenys bei atnaujinami kartą per 7-ias dienas. Visa agreguota informacija pateikiama per „API“

Kam skirtas?

Puslapis skirtas „NKOM“ klientams, kurie nori greitai pasirinktam miestui matyti artimiausius atliekų išvežimo grafikus.

Tuo pačiu projektas skirtas ir developeriams, kuriems reikia patikimo „JSON API“ integracijoms, automatizacijoms ar papildomoms klientų aplikacijoms.

Svarbu žinoti

Aš nedirbu „NKOM'e“ ir nesu kaip nors su jais susijęs - Todėl pamatę kokius nors neatitikimus pirmiausia pasitikrinkite juoshttps://www.nkom.lt/kita.html puslapyje bei komunikuokite tiesiai su NKOM. Man galite rašyti tik šios svetainės veikimo/neveikimo klausimais el. paštu:projektas[eta]gmail.com

„API“ dokumentacija

Žemiau pateikti „API“ endpointai. Visi atsakymai grąžinami „JSON“ formatu.

GET /health

Serviso būklės monitorinimui.

{
  "ok": true,
  "service": "nkom",
  "now": "2026-03-17T08:00:00.000Z",
  "uptimeSeconds": 123,
  "memory": { "usedMb": 64.5 },
  "cache": { "xlsxCount": 2 }
}

GET /cities

Grąžina visų rastų miestų sąrašą. (Labai tikėtina, kad jūsų miesto pavadinimo nebus arba jis bus netikslus)

{
  "sourcePageUrl": "https://...",
  "count": 3,
  "cities": ["Kalviskes", "Avizieniai", "Didzioji Riese"]
}

GET /events?keyword=<miestas>

Pagrindinis endpointas, kuris grąžina miesto atliekų išvežimo tvarkaraščius.

{
  "keyword": "Kalviskes",
  "sourcePageUrl": "https://...",
  "count": 2,
  "lastUpdatedAt": "2026-03-16T21:15:00.000Z",
  "events": [
    {
      "date": "2026-03-20",
      "type": "Misiu komunaliniu atlieku isvezimas",
      "link": "https://calendar.google.com/...",
      "sourceFileUrl": "https://...xlsx"
    }
  ]
}