# Naudotojo vadovas (https://guides.dataportal.gov.lt/lt/docs/guide)



Lietuvos duomenų portalas sutelkia valstybės ir viešojo sektoriaus duomenis į vieną vietą. Šis vadovas padės portale susigaudyti — rasti reikiamą informaciją ir ja pasinaudoti.

Ką rasite portale:

* **Oficialiąją statistiką** — pagal tarptautinius standartus rengiamus rodiklius nuo gyventojų iki ekonomikos.
* **Atvirus duomenis** — laisvai naudojamus įvairių institucijų rinkinius.
* **Geoerdvinius duomenis** — su vietove susietus, žemėlapyje rodomus duomenis.
* **Klasifikatorius** — standartizuotus kodų ir reikšmių sąrašus (pavyzdžiui, EVRK).
* **Panaudojimo atvejus** — švieslentes, leidinius ir pavyzdžius, kaip duomenys pritaikomi.
* **Istorinius duomenis** — ne tik naujausius, bet ir tarpukario bei sovietmečio laikotarpių duomenis.

Duomenys suskirstyti pagal temas, o iki reikiamo rinkinio dažnai užtenka vieno klausimo [išmaniajai paieškai](https://guides.dataportal.gov.lt/lt/docs/guide/smart-search).

## Nuo ko pradėti [#nuo-ko-pradėti]

<Cards>
  <Card title="Apie portalą" href="https://guides.dataportal.gov.lt/lt/docs/guide/about-portal" description="Portalo idėja: vieni vartai, standartai ir sprendimai duomenimis." />

  <Card title="Išmanioji paieška" href="https://guides.dataportal.gov.lt/lt/docs/guide/smart-search" description="Klauskite įprasta kalba ir raskite tinkamiausius duomenis." />

  <Card title="Duomenų naršymas" href="https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data" description="Katalogo filtravimas, peržiūra ir atsisiuntimas." />

  <Card title="Klasifikatoriai" href="https://guides.dataportal.gov.lt/lt/docs/guide/classifiers" description="Nacionaliniai ir tarptautiniai klasifikatoriai." />

  <Card title="Naujienos ir įžvalgos" href="https://guides.dataportal.gov.lt/lt/docs/guide/news" description="Kalendorius, informaciniai pranešimai ir duomenų įžvalgos." />

  <Card title="Panaudojimo atvejai" href="https://guides.dataportal.gov.lt/lt/docs/guide/use-cases" description="Švieslentės, leidiniai ir pavyzdžiai, kaip duomenys pritaikomi." />

  <Card title="Paslaugos" href="https://guides.dataportal.gov.lt/lt/docs/guide/services" description="VDA duomenų paslaugos: duomenų gavimas, infrastruktūra, mokymai ir jų užsakymas." />

  <Card title="Prenumerata" href="https://guides.dataportal.gov.lt/lt/docs/guide/subscription" description="Naujienų prenumerata portale." />

  <Card title="Portalo nustatymai" href="https://guides.dataportal.gov.lt/lt/docs/guide/portal-settings" description="Kalbos ir prieinamumo režimo perjungimas." />
</Cards>


# Apie portalą (https://guides.dataportal.gov.lt/lt/docs/guide/about-portal)



Lietuvos duomenų portalas sutelkia valstybės ir viešojo sektoriaus duomenis į vieną vietą — oficialiąją statistiką, atvirus ir geoerdvinius duomenis bei jų panaudojimo atvejus. Portalą administruoja Valstybės duomenų agentūra (VDA), atsakinga už oficialiąją statistiką ir valstybės duomenų valdyseną. Užuot ieškojus po pavienius registrus ir svetaines, duomenys čia pasiekiami kartu, su bendra paieška ir naršymu.

## Idėja [#idėja]

* **Vieni vartai į valstybės duomenis.** Skirtingų institucijų duomenys pateikiami vienoje platformoje — nuo surinkimo iki panaudojimo.
* **Bendri standartai ir sąveikumas.** Duomenys aprašomi vieningais metaduomenimis ir klasifikatoriais, todėl juos galima palyginti, susieti ir apdoroti automatiškai.
* **Pritaikyti mašininiam naudojimui.** Struktūruoti duomenys, atviri formatai (CSV, JSON, Parquet) ir API leidžia juos naudoti analizėje ir dirbtinio intelekto sprendimuose be papildomo tvarkymo.
* **Atviri duomenys visuomenei.** Laisvai prieinami duomenys skirti verslui, tyrėjams, viešajam sektoriui ir visiems, kuriems jie naudingi.
* **Sprendimai, pagrįsti duomenimis.** Patikima ir aktuali informacija padeda priimti sprendimus ir informuoti visuomenę.

## Kam skirtas [#kam-skirtas]

Portalas skirtas visiems, kam reikia valstybės duomenų — gyventojams, verslui, tyrėjams ir viešojo sektoriaus institucijoms.


# Išmanioji paieška (https://guides.dataportal.gov.lt/lt/docs/guide/smart-search)



Portalo paieška supranta įprastą kalbą: galite įrašyti visą klausimą, ne tik raktažodį. Pavyzdžiui, užklausa &#x2A;*„vidutinis darbo užmokestis pagal apskritis"** viršuje pateikia darbo užmokesčio pagal apskritis rinkinį. Ieškoma visame portale — duomenų rinkiniuose, statistikoje, klasifikatoriuose, panaudojimo atvejuose ir organizacijose.

<SearchWalkthrough lang="lt" />

## Kaip ieškoti [#kaip-ieškoti]

<Steps>
  <Step>
    ### Atverkite paiešką [#atverkite-paiešką]

    Paiešką galima atverti dviem būdais:

    ![Du būdai atverti išmaniąją paiešką, pažymėta 1–2: 1 paieškos ženkliukas portalo antraštėje; 2 mygtukas Ieškoti duomenų pradžios puslapyje](https://guides.dataportal.gov.lt/guide/paieskos-atidarymas.png)

    1. **Paieškos ženkliukas** portalo antraštėje — pasiekiamas iš bet kurio puslapio.
    2. Mygtukas **Ieškoti duomenų** pradžios puslapyje.
  </Step>

  <Step>
    ### Įrašykite klausimą [#įrašykite-klausimą]

    Rašykite įprasta kalba — žodį, frazę ar visą klausimą. Tikslaus rinkinio pavadinimo žinoti nereikia. Paspauskite **Ieškoti** arba klavišą **Enter**.

    ![Išmaniosios paieškos laukas su įrašyta užklausa „vidutinis darbo užmokestis pagal apskritis“](https://guides.dataportal.gov.lt/guide/paieska-klausimas.png)

    Užklausa įrašoma į naršyklės adresą, todėl rezultatų nuorodą galima nukopijuoti ir persiųsti.
  </Step>

  <Step>
    ### Peržiūrėkite rezultatus [#peržiūrėkite-rezultatus]

    Rezultatai rikiuojami pagal atitiktį — tinkamiausi rodomi viršuje. Virš sąrašo nurodyta, kiek jų rasta. Kiekvienas rezultatas sudarytas vienodai:

    ![Vienas išmaniosios paieškos rezultatas, pažymėta 1–5: 1 turinio tipas (Statistika); 2 šaltinio, būsenos ir periodiškumo žymos (Oficialioji statistika, Parengtas, Kasmetinis); 3 pavadinimas su pjūviu pagal apskritis; 4 datos ir duomenų teikėjas; 5 atsisiuntimo formatai su „+1“](https://guides.dataportal.gov.lt/guide/paieskos-rezultatas.png)

    1. **Turinio tipas** — pavyzdžiui, *Statistika* (oficialiosios statistikos rodiklis) arba *Duomenys* (duomenų rinkinys).
    2. **Šaltinis, būsena ir periodiškumas** — pavyzdžiui, *Oficialioji statistika*, *Parengtas* ir *Kasmetinis*. *Nebeatnaujinamas* reiškia, kad naujų duomenų nebus.
    3. **Pavadinimas** — pirma rodiklis, po „|" — pjūvis. Šis rinkinys pateikia duomenis pagal apskritis.
    4. **Paskelbimo ir atnaujinimo datos** bei **duomenų teikėjas**.
    5. **Atsisiuntimo formatai.** „+1" reiškia, kad yra dar vienas formatas (šiam rinkiniui — JSON).
  </Step>

  <Step>
    ### Atrinkite pagal turinio tipą [#atrinkite-pagal-turinio-tipą]

    Virš rezultatų spustelėkite vieną ar kelis turinio tipo filtrus. Filtrai derinami — pažymėję **Statistika** ir **Klasifikatoriai**, matysite abu tipus. **Visi** filtrus atstato.

    ![Turinio tipo filtrai virš paieškos rezultatų, pažymėti du: Statistika ir Klasifikatoriai](https://guides.dataportal.gov.lt/guide/paieska-filtrai.png)

    Ką reiškia kiekvienas filtras — [lentelėje žemiau](#ką-apima-paieška).
  </Step>

  <Step>
    ### Atverkite rinkinį [#atverkite-rinkinį]

    Spustelėkite rezultatą — atsivers [rinkinio puslapis](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page) su aprašu, duomenų lentele ir atsisiuntimu.
  </Step>
</Steps>

## Ką apima paieška [#ką-apima-paieška]

| Filtras                         | Ką rodo                              |
| ------------------------------- | ------------------------------------ |
| **Visi**                        | Visus rezultatus kartu.              |
| **Duomenys**                    | Duomenų rinkinius.                   |
| **Statistika**                  | Oficialiosios statistikos rodiklius. |
| **Klasifikatoriai**             | Klasifikatorius ir žodynus.          |
| **Valstybės ištekliai**         | Valstybės informacinius išteklius.   |
| **Duomenų panaudojimo atvejai** | Pavyzdžius, kaip duomenys panaudoti. |
| **Organizacijos**               | Duomenų teikėjus.                    |

## Jei nieko nerandama [#jei-nieko-nerandama]

Portalas parodo pranešimą &#x2A;*„Rezultatų nerasta"**. Tuomet:

* **Patikrinkite filtrus.** Pažymėtas turinio tipas gali neturėti atitikmenų — spustelėkite **Visi**.
* **Ieškokite bendriau.** Palikite svarbiausius žodžius, pavyzdžiui, „darbo užmokestis" vietoj ilgo klausimo.
* **Patikrinkite rašybą** — ypač lietuviškas raides.

<Tips>
  - **Būkite konkretūs.** Pridėję pjūvį (pavyzdžiui, „pagal apskritis", „ketvirčiais") gausite tikslesnius rezultatus.
  - **Ieškote konkretaus rinkinio?** Naudokite [katalogo filtrus](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data) — ten galima tiksliai atsirinkti pagal temą, tipą ar statusą.
</Tips>


# Katalogas ir filtrai (https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data)



Duomenų kataloge sudėti visi portalo duomenų rinkiniai. Iki reikiamo galima prisikapstyti trimis būdais — naršant temas, ieškant kataloge arba filtruojant — ir dažniausiai greičiausia juos derinti. Jei norite paklausti įprasta kalba ir ieškoti visame portale, naudokite [išmaniąją paiešką](https://guides.dataportal.gov.lt/lt/docs/guide/smart-search).

## Naršymas pagal temas [#naršymas-pagal-temas]

Meniu **Duomenys ir statistika** atverkite **Temos**:

![Atvertas meniu Duomenys ir statistika, pažymėta 1–2: 1 punktas Temos; 2 13 temų plytelių nuo Aplinkos iki Žemės ūkio, žuvininkystės, miškininkystės ir maisto](https://guides.dataportal.gov.lt/guide/katalogo-temos.png)

1. **Temos** — pirmasis meniu punktas. Žemiau esantys punktai veda į kitas duomenų grupes, pavyzdžiui, *Oficialioji statistika* ar *Atviri duomenys*.
2. **13 temų** — nuo *Aplinkos* iki *Žemės ūkio, žuvininkystės, miškininkystės ir maisto*. Spustelėjus temą, atsiveria tik tos srities rinkinių katalogas.

## Paieška ir rezultatai [#paieška-ir-rezultatai]

Virš rinkinių sąrašo — paieška, aktyvūs filtrai, rezultatų skaičius ir rikiavimas:

![Katalogo rezultatų viršus, pažymėta 1–4: 1 paieška kataloge; 2 aktyvių filtrų žymos ir Valyti filtrus; 3 rezultatų skaičius („Rodoma 1–24 iš 131“); 4 rikiavimas](https://guides.dataportal.gov.lt/guide/katalogo-rezultatai.png)

1. **Paieška kataloge** — ieško tik tarp duomenų rinkinių ir veikia kartu su pažymėtais filtrais. Užuominoje nurodyta, tarp kiek rinkinių bus ieškoma.
2. **Aktyvūs filtrai** — kiekvienas pažymėtas filtras rodomas kaip žyma. **×** pašalina vieną, **Valyti filtrus** — visus.
3. **Rezultatų skaičius** — kiek rinkinių atitinka paiešką ir filtrus (pavyzdžiui, „Rodoma 1–24 iš 131").
4. **Rikiavimas** — *Aktualiausi*, *Naujausi*, *Seniausi*, *Pavadinimas A-z* arba *Pavadinimas Z-a*.

## Filtrai [#filtrai]

Katalogo kairėje yra filtrų skydelis su šešiomis grupėmis. Paveiksle jos sunumeruotos ta pačia tvarka, kaip portale ir aprašyta žemiau:

![Katalogo filtrų skydelis su šešiomis suskleistomis grupėmis, pažymėta 1–6: Duomenų rinkinio tipas, Duomenų rinkinio kategorija, Prieigos teisės, Duomenų rinkinio statusas, Duomenų tema, Raktažodžiai](https://guides.dataportal.gov.lt/guide/katalogo-filtrai.png)

<Accordions type="single">
  <Accordion title="1. Duomenų rinkinio tipas">
    Techninis rinkinio pobūdis — iš viso beveik trisdešimt tipų. Kasdien aktualiausi:

    * **Lentelė**, **Statistiniai duomenys** ir **Geoerdviniai duomenys** — patys duomenys.
    * **Didelės vertės duomenų rinkinys** — ES išskirti ypač naudingi duomenys.
    * **Nacionalinis klasifikatorius**, **Tarptautinis klasifikatorius**, **Kodų sąrašas**, **Taksonomija**, **Tezauras** — [klasifikatoriai](https://guides.dataportal.gov.lt/lt/docs/guide/classifiers) ir žodynai.

    Kiti tipai (schemos, ontologijos, programų profiliai ir pan.) skirti metaduomenų specialistams. Grupė turi savo paieškos laukelį.
  </Accordion>

  <Accordion title="2. Duomenų rinkinio kategorija">
    **Oficialioji statistika**, **Atviri duomenys** arba **Eksperimentinė statistika**.
  </Accordion>

  <Accordion title="3. Prieigos teisės">
    Kam duomenys prieinami: **Viešas**, **Neviešas**, **Konfidencialus**, **Neskelbtinas**, **Taikomi ribojimai**, **Laikinieji duomenys**. Laisvai naudojamiems rinkitės **Viešas**.
  </Accordion>

  <Accordion title="4. Duomenų rinkinio statusas">
    Rinkinio būklė: **Parengtas**, **Rengiamas**, **Integruotas**, **Inventorintas**, **Laikinieji duomenys**, **Nebeatnaujinamas**, **Nebenaudojamas**, **Panaikintas**. Aktualiems duomenims rinkitės **Parengtas**.
  </Accordion>

  <Accordion title="5. Duomenų tema">
    Tos pačios 13 sričių kaip meniu. Galima žymėti kelias.
  </Accordion>

  <Accordion title="6. Raktažodžiai">
    Rinkiniams priskirti raktažodžiai su savo paieškos laukeliu — patogu, kai tikslų raktažodį jau žinote.
  </Accordion>
</Accordions>

Skirtingų grupių filtrai sumuojasi: pažymėję temą **Energetika** ir kategoriją **Oficialioji statistika**, gausite tik abi sąlygas atitinkančius rinkinius. Pasirinkimai įrašomi į adresą, tad nuorodą su filtrais ir paieška galima išsaugoti ar nusiųsti kolegai.

<Callout title="Oficialioji statistika prideda statusą „Parengtas“">
  Pažymėjus kategoriją **Oficialioji statistika**, portalas kartu pažymi ir statusą **Parengtas** — tai matysite juostoje **Aktyvūs filtrai**. Jei ieškote ir nebeatnaujinamų rinkinių, šią žymą pašalinkite.
</Callout>

## Rinkinio kortelė [#rinkinio-kortelė]

Kiekvienas rezultatas kataloge — kortelė su svarbiausia informacija:

![Viena katalogo rinkinio kortelė, pažymėta 1–7: 1 kategorijos, statuso ir dažnumo žymos (Oficialioji statistika, Parengtas, Kasmetinis); 2 pavadinimas; 3 datos ir teikėjas; 4 pamėgimų, atsisiuntimų ir peržiūrų skaičiai; 5 trumpas aprašas; 6 raktažodžiai su „+5“; 7 atsisiuntimo formatai](https://guides.dataportal.gov.lt/guide/katalogo-kortele.png)

1. **Kategorija, statusas ir atnaujinimo dažnumas** — pavyzdžiui, *Oficialioji statistika*, *Parengtas*, *Kasmetinis*.
2. **Pavadinimas** — pirma rodiklis, po „|" — pjūviai.
3. **Paskelbimo ir atnaujinimo datos** bei **teikėjas**.
4. **Pamėgimų, atsisiuntimų ir peržiūrų skaičius.**
5. **Trumpas aprašas.**
6. **Raktažodžiai** — „+5" reiškia, kad yra dar penki.
7. **Atsisiuntimo formatai.**

Radę tinkamą, spustelėkite pavadinimą — atsivers [rinkinio puslapis](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page).

<Tips>
  * **Derinkite paiešką su filtrais.** Pažymėkite temą ir kategoriją, tada įrašykite žodį — paieška vyks tik tarp atrinktų rinkinių.
  * **Ieškote naujausių duomenų?** Rikiuokite pagal **Naujausi**.
  * **Nežinote, nuo ko pradėti?** Užduokite klausimą [išmaniajai paieškai](https://guides.dataportal.gov.lt/lt/docs/guide/smart-search) — ji ieško visame portale, ne tik kataloge.
</Tips>


# Rinkinio puslapis (https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page)



Atvėrus rinkinį, viršuje matote jo pavadinimą, o aplink — informaciją, padedančią nuspręsti, ar duomenys tinka.

![Duomenų rinkinio puslapio viršus, pažymėta 1–8: 1 kategorijos, statuso ir atnaujinimo dažnumo žymos; 2 pavadinimas; 3 paskelbimo ir atnaujinimo datos su pamėgimų, atsisiuntimų ir peržiūrų skaičiais; 4 aprašas; 5 teikėjas ir kūrėjas; 6 duomenų rinkinio informacija (prieigos teisės, tipas, periodiškumas, tema); 7 veiksmų mygtukai; 8 skirtukai](https://guides.dataportal.gov.lt/guide/rinkinio-virsus.png)

1. **Kategorija, statusas ir atnaujinimo dažnumas** — tos pačios žymos kaip [kataloge](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data).
2. **Pavadinimas** — pirma rodiklis, po „|" — pjūviai.
3. **Paskelbimo ir atnaujinimo datos** bei **pamėgimų, atsisiuntimų ir peržiūrų skaičius**. Atnaujinimo data svarbesnė — ji rodo, kada duomenys paskutinį kartą keitėsi.
4. **Aprašas** — ką rinkinys apima.
5. **Teikėjas** — institucija, paskelbusi rinkinį portale, ir **kūrėjas** — institucija, sukūrusi pačius duomenis. Dažnai tai ta pati įstaiga.
6. **Duomenų rinkinio informacija** — prieigos teisės, tipas, atnaujinimo periodiškumas ir tema.
7. **Veiksmai** — cituoti, pasidalyti, kopijuoti nuorodą ir parašyti atsiliepimą. Aprašyti žemiau.
8. **Skirtukai** — duomenys, metaduomenys ir kita. Aprašyti žemiau.

## Cituoti, pasidalyti, pranešti [#cituoti-pasidalyti-pranešti]

Po duomenų rinkinio informacija yra keturi mygtukai:

![Rinkinio veiksmų mygtukai, pažymėta 1–4: 1 Cituoti, 2 Pasidalinti, 3 Kopijuoti nuorodą, 4 Grįžtamojo ryšio forma](https://guides.dataportal.gov.lt/guide/rinkinio-veiksmai.png)

1. **Cituoti** — pasirinkite formatą: *EU Data Citation*, *APA*, *Harvard* arba *Vancouver*.
2. **Pasidalinti** — per *Facebook*, *LinkedIn*, *X*, *Messenger* arba el. paštu.
3. **Kopijuoti nuorodą** — nukopijuoja rinkinio adresą.
4. **Grįžtamojo ryšio forma** — parašykite atsiliepimą apie šį rinkinį: vardą, pavardę, el. paštą ir žinutę (iki 2 500 ženklų), tada **Siųsti**.

Pasirinkus citavimo formatą, atsiveria langas su paruošta citata — nukopijuokite ją mygtuku **Kopijuoti**:

![Langas „Cituokite šį rinkinį“ su APA citata — institucija, rinkinio pavadinimas, žyma „Data set“ ir rinkinio adresas — ir mygtuku Kopijuoti](https://guides.dataportal.gov.lt/guide/rinkinio-citata.png)

## Skirtukai [#skirtukai]

Rinkinio turinys suskirstytas į šešis skirtukus. Atidaromas pirmasis — **Duomenys**.

### Duomenys [#duomenys]

Pati duomenų lentelė. Ji rodoma ta kalba, kuria naršote portalą — lietuviškame portale jos pavadinimas baigiasi „(lietuvių k.)", angliškame — „(English)". Lentelės antraštėje nurodyta, kada ji atnaujinta, ir kokiais formatais ją galima atsisiųsti.

Virš lentelės perjungiami rodiniai (*Lentelė*, *Struktūra*, *Pateikties informacija*), o mygtukais **Stulpeliai** ir **Filtrai** atrenkama, ką rodyti — žr. [Duomenų lentelė](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table). Mygtukas **Eksportuoti** atsisiunčia duomenis — žr. [Atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading).

### Metaduomenys [#metaduomenys]

Išsamus rinkinio aprašas, suskirstytas į šešias grupes. Prie kai kurių laukų yra ženkliukas ⓘ — užvedus pelę, parodomas lauko paaiškinimas.

![Metaduomenų skirtukas su šešiomis grupėmis, pažymėta 1–6: 1 Identifikavimas, 2 Versija ir datos, 3 Aprėptis, 4 Naudojimo sąlygos (licencija), 5 Atsakingos institucijos, 6 Dokumentacija (metodiniai aprašai PDF)](https://guides.dataportal.gov.lt/guide/rinkinio-metaduomenys.png)

1. **Identifikavimas** — *Identifikatorius* (pavyzdžiui, `SD003146` — tas pats kodas yra rinkinio adrese), *Kitas identifikatorius*, *Kalbos*, *Kilmė* (papildoma informacija apie rinkinio istoriją) ir *Raktažodžiai*.
2. **Versija ir datos** — *Versija*, *Versijos pastabos*, *Paskelbimo* ir *Pakeitimo data*, *Statusas*.
3. **Aprėptis** — *Laiko aprėptis* (laikotarpis, kurį apima rinkinys, pavyzdžiui, 1995–2025 m.), *Laiko skiriamoji geba* (mažiausias laiko intervalas tarp stebėjimų: „1 metai" — kasmetiniai duomenys), *Geografinė aprėptis* ir *Erdvinė skiriamoji geba* (mažiausias atstumas tarp objektų metrais — geoerdviniams duomenims).
4. **Naudojimo sąlygos** — *Licencija*, *Taikytini teisės aktai* ir *Atitiktis standartui*.
5. **Atsakingos institucijos** — *Duomenų valdytojas* nustato, kokiais tikslais ir priemonėmis duomenys tvarkomi, o *Duomenų tvarkytojas* juos tvarko pagal valdytojo nustatytą tvarką.
6. **Dokumentacija** — nuorodos į metodinius aprašus (PDF), pavyzdžiui, „Darbo užmokesčio statistika" lietuvių ir anglų kalbomis. Čia paaiškinta, kaip duomenys renkami ir skaičiuojami.

<Callout title="Ar galiu laisvai naudoti duomenis?">
  Tai nurodyta eilutėje **Licencija**. Pavyzdžiui, *Creative Commons Priskyrimas 4.0 Tarptautinė* (CC BY 4.0) reiškia, kad duomenis galima naudoti laisvai, nurodžius šaltinį — tam praverčia mygtukas **Cituoti**.
</Callout>

### Duomenų atnaujinimas [#duomenų-atnaujinimas]

Rinkinio atnaujinimų laiko juosta: viršuje — suplanuoti, žemiau — jau įvykę.

![Duomenų atnaujinimo skirtuko laiko juosta, pažymėta 1–4: 1 atnaujinimo data ir laikas; 2 žyma Nepaskelbtas prie suplanuoto atnaujinimo; 3 papildymo laikotarpis (2026K3) ir atnaujinimo laikotarpiai (2025 m. ketvirčiai); 4 žyma Paskelbtas prie įvykusio atnaujinimo](https://guides.dataportal.gov.lt/guide/rinkinio-atnaujinimai.png)

1. **Data ir laikas** — kada atnaujinimas paskelbtas arba bus paskelbtas (dažniausiai 09:00).
2. **Nepaskelbtas** — suplanuotas atnaujinimas. Tie patys įrašai rodomi ir [kalendoriuje](https://guides.dataportal.gov.lt/lt/docs/guide/news/calendar).
3. **Ką atnaujinimas apima.** *Papildymo laikotarpis* — pridedami naujo laikotarpio duomenys. *Atnaujinimo laikotarpis* — patikslinami jau paskelbti duomenys. Viename įraše gali būti abu: šiame pavyzdyje pridedamas 2026 m. III ketvirtis ir patikslinami visi 2025 m. ketvirčiai.
4. **Paskelbtas** — įvykęs atnaujinimas.

Laikotarpiai žymimi taip:

| Žymėjimas | Reiškia                                 |
| --------- | --------------------------------------- |
| `2025`    | Metai                                   |
| `2026K3`  | 2026 m. III ketvirtis (*K* — ketvirtis) |
| `2026M09` | 2026 m. rugsėjis (*M* — mėnuo)          |

<Tips>
  * **Kada bus nauji duomenys?** Įrašai surikiuoti nuo vėliausio, todėl artimiausias atnaujinimas — **žemiausias** įrašas su žyma **Nepaskelbtas**, esantis tiesiai virš pirmojo **Paskelbtas**.
  * **Skaičiai pasikeitė?** Įrašas su *Atnaujinimo laikotarpiu* reiškia, kad ankstesni duomenys buvo patikslinti — įprasta statistikoje, kai gaunama išsamesnė informacija.
</Tips>

### Šaltiniai, Susiję duomenų rinkiniai, Panaudojimo atvejai [#šaltiniai-susiję-duomenų-rinkiniai-panaudojimo-atvejai]

* **Šaltiniai** — iš kur duomenys gauti.
* **Susiję duomenų rinkiniai** — kiti susiję rinkiniai.
* **Panaudojimo atvejai** — kur šis rinkinys jau [panaudotas](https://guides.dataportal.gov.lt/lt/docs/guide/use-cases).

<Callout type="info" title="Šie skirtukai dažnai tušti">
  Šiuo metu daugumoje rinkinių šie trys skirtukai rodo „Duomenų nėra" — tai reiškia, kad informacija dar nepateikta, o ne klaidą.
</Callout>

Kaip dirbti su pačia lentele — skaitykite [Duomenų lentelė](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table).


# Duomenų lentelė (https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table)



Skirtuke **Duomenys** rinkinys rodomas lentele — ją galima naršyti tiesiai naršyklėje, neatsisiunčiant failo. Visi peržiūros valdikliai yra virš lentelės ir jos antraštėse.

![Duomenų lentelės valdikliai, pažymėta 1–4: 1 rodinių perjungiklis; 2 mygtukas Stulpeliai; 3 mygtukas Filtrai; 4 stulpelio antraštė Eilutės identifikatorius (tipas string) su rikiavimo ir filtravimo ženkliukais](https://guides.dataportal.gov.lt/guide/lentele-valdikliai-v2.png)

1. **Rodiniai** — trys rinkinio rodymo būdai.
2. **Stulpeliai** — kuriuos stulpelius rodyti.
3. **Filtrai** — eilučių filtravimas.
4. **Stulpelio antraštė** su duomenų tipu (čia *Eilutės identifikatorius*, tipas `string`) bei rikiavimo ir filtravimo ženkliukais. Tokią antraštę turi kiekvienas stulpelis.

Virš rodinių, lentelės antraštėje, yra mygtukas **Eksportuoti** (žr. [Atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading)) ir rodyklė **Suskleisti**, kuri paslepia lentelę.

## Rodiniai [#rodiniai]

Virš lentelės (1) perjungiami trys rodymo būdai:

| Rodinys                    | Ką rodo                                                                                                                                             |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Lentelė**                | Eilutės ir stulpeliai — pagrindinis vaizdas.                                                                                                        |
| **Struktūra**              | Kiek rinkinyje eilučių ir stulpelių, kiekvieno stulpelio pavadinimas, API pavadinimas ir tipas. Žr. [Struktūra](#struktūra).                        |
| **Pateikties informacija** | Techniniai rinkinio pateikties duomenys: identifikatoriai, API nuoroda, formatai, licencija. Žr. [Pateikties informacija](#pateikties-informacija). |

## Puslapiai [#puslapiai]

Lentelė rodoma dalimis. Po ja nurodyta, kurios eilutės matomos (pavyzdžiui, „1–24 iš 390"), yra puslapių numeriai ir sąrašas **Rodoma įrašų** — po **24**, **48** arba **96** eilutes puslapyje.

## Rikiavimas [#rikiavimas]

Kiekvienos stulpelio antraštės dešinėje (4) yra du ženkliukai. **Rikiavimo** ženkliukas perjungia tvarką paeiliui:

1. pirmas spustelėjimas — didėjančia tvarka;
2. antras — mažėjančia;
3. trečias — grąžina pradinę tvarką.

Rikiavimas, filtrai ir atvertas puslapis įrašomi į naršyklės adreso eilutę, todėl nukopijavę adresą kitam parodysite tą patį vaizdą.

## Stulpelio meniu [#stulpelio-meniu]

**Filtravimo** ženkliukas antraštėje atveria to stulpelio meniu:

![Stulpelio Laikotarpis meniu, pažymėta 1–5: 1 Rikiuoti didėjančia ir mažėjančia tvarka; 2 Pažymėti visus; 3 paieškos laukas Ieškoti; 4 reikšmių sąrašas su žymimaisiais langeliais (2025, 2024, …); 5 mygtukas Pritaikyti](https://guides.dataportal.gov.lt/guide/lentele-stulpelio-meniu.png)

1. **Rikiavimas** — tas pats kaip rikiavimo ženkliuku.
2. **Pažymėti visus** — pažymi visas reikšmes (kai visos pažymėtos — **Nuimti visus**).
3. **Paieška** — greitai randa reikšmę ilgame sąraše, pavyzdžiui, vieną savivaldybę.
4. **Reikšmės** — pažymėkite tas, kurias norite palikti.
5. **Pritaikyti** — atrenka eilutes.

Skaičių stulpelyje (tipas `double` ar `integer`) vietoj reikšmių sąrašo rodomas **Skaičių filtras**: įrašykite mažiausią ir didžiausią reikšmę. Čia galima ir **Slėpti tuščias reikšmes**, o mygtukas **Atstatyti** grąžina pradinį intervalą.

## Stulpeliai [#stulpeliai]

Mygtukas **Stulpeliai** (2) atveria šoninį langą **Stulpelių redagavimas** — sąraše **Aktyvūs stulpeliai** kiekvieną stulpelį galima įjungti arba išjungti.

![Stulpelių redagavimo langas, pažymėta 1–2: 1 kiekvieno stulpelio įjungimo jungiklis (pažymėtas Eilutės identifikatorius); 2 mygtukas Išsaugoti šalia Uždaryti](https://guides.dataportal.gov.lt/guide/lentele-stulpeliai-v2.png)

1. **Stulpelio jungiklis** — įjungtas (žalias) stulpelis rodomas, išjungtas — slepiamas. Čia pažymėtas *Eilutės identifikatorius*.
2. **Išsaugoti** — pritaiko pakeitimus (mygtukas **Uždaryti** uždaro nieko nepakeitęs).

<Tips>
  * **Išjunkite „Eilutės identifikatorių".** Lentelė prasideda techniniu kodu (pavyzdžiui, `fc9ff094-fe94-…`), skirtu sistemoms, ne skaitymui. Lange **Stulpelių redagavimas** išjunkite jo jungiklį ir spustelėkite **Išsaugoti** — ypač telefone, kur šis stulpelis užima visą pirmą ekraną.
</Tips>

Po kiekvieno stulpelio antrašte (paveiksle aukščiau — 4) nurodytas duomenų tipas: `string` — tekstas, `double` — skaičius su kableliu, `integer` — sveikas skaičius.

## Eilučių filtrai [#eilučių-filtrai]

Mygtukas **Filtrai** (3) atveria šoninį langą su visais stulpeliais vienoje vietoje — patogu, kai norite filtruoti pagal kelis stulpelius iš karto, pavyzdžiui, vienus metus ir vieną apskritį.

![Filtrų langas, pažymėta 1–3: 1 kiekvieno stulpelio išskleidžiama eilutė su filtro sąlygomis; 2 mygtukas Valyti filtrus; 3 mygtukas Pritaikyti filtrus su aktyvių filtrų skaičiumi](https://guides.dataportal.gov.lt/guide/lentele-filtrai-v2.png)

1. Kiekvienas stulpelis — **išskleidžiama eilutė**; spustelėję atversite tas pačias sąlygas kaip [stulpelio meniu](#stulpelio-meniu).
2. **Valyti filtrus** — pašalina visus filtrus vienu spustelėjimu.
3. **Pritaikyti filtrus** — pritaiko pasirinkimus; skaičius skliaustuose rodo, kiek filtrų šiuo metu aktyvių.

Filtrai svarbūs ne tik peržiūrai: eksportuojant galėsite pasirinkti, ar atsisiųsti **visus**, ar tik **išfiltruotus** duomenis.

## Tuščios reikšmės ir sutartiniai simboliai [#tuščios-reikšmės-ir-sutartiniai-simboliai]

Brūkšnelis `-` langelyje reiškia, kad langelis tuščias. Kai tuščia pati rodiklio reikšmė, priežastį paaiškina stulpelis **Sutartinis simbolis** — jame žodžiais parašyta, pavyzdžiui, kad rodiklis tokiai išraiškai neskaičiuojamas, duomenų nėra ar jie konfidencialūs. Tame pačiame stulpelyje pažymima ir tai, kad reikšmė išankstinė ar patikslinta. Jei stulpelyje **Sutartinis simbolis** matote `-`, pastabų tai eilutei nėra.

## Struktūra [#struktūra]

Rodinyje **Struktūra** viršuje nurodytas **eilučių** ir **stulpelių skaičius**, o lentelėje — kiekvienas stulpelis:

| Stulpelis              | Ką rodo                                                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Pavadinimas**        | Kaip stulpelis vadinasi lentelėje, pavyzdžiui, *Laikotarpis*.                                                                   |
| **API pavadinimas**    | Techninis pavadinimas, pavyzdžiui, `laikotarpis` — jį naudokite užklausose per [API](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading). |
| **Informacijos tipas** | `string`, `double` arba `integer`.                                                                                              |

Norite žinoti, ką rodiklis tiksliai matuoja? Tai paaiškinta ne čia, o skirtuko **Metaduomenys** [dokumentacijoje](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page#metaduomenys).

## Pateikties informacija [#pateikties-informacija]

Rodinyje **Pateikties informacija** — techniniai šios rinkinio pateikties (konkrečios kalbos lentelės) duomenys:

* **Identifikatorius** ir **Kitas identifikatorius** — pavyzdžiui, `sdr003146_lt` ir statistikos lentelės kodas `S3R640_M3060807_1_lt`;
* **Kalba**, **Aprašymas** ir **Statusas**;
* **Prieigos nuoroda** — API adresas su kopijavimo mygtuku, **Prieigos paslauga** ir **Prieinamumo lygis**;
* **Formatas** (pavyzdžiui, *Parquet*, *CSV*, *JSON*), **Medijos tipas**, **Pakavimo formatas**, **Dydis** ir **Kontrolinė suma**;
* **Paskelbimo** ir **Pakeitimo data**;
* **Licencija**, **Taikytini teisės aktai**, **ODRL politika** ir **Pateikties teisės**;
* **Erdvinė skiriamoji geba**, **Laiko raiška** ir **Susietos schemos**.

Dauguma šių laukų kartoja [metaduomenis](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page#metaduomenys); čia jie aprašo konkrečią lentelę, pavyzdžiui, jos kalbą ir API adresą.

Atsirinkę, ko reikia, pereikite prie [atsisiuntimo](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading).


# Atsisiuntimas (https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading)



Duomenis galima parsisiųsti failu arba gauti programiškai — abu būdai slypi po žaliu mygtuku **Eksportuoti** duomenų lentelės antraštėje.

![Langas Eksportuoti rinkinį, skirtukas Parsisiuntimas, pažymėta 1–4: 1 skirtukai Parsisiuntimas ir API endpoint; 2 eksporto formato sąrašas (pasirinktas JSON); 3 apimtis — Visi duomenys (390 eilučių) arba Išfiltruoti duomenys (13 eilučių); 4 mygtukas Parsisiųsti](https://guides.dataportal.gov.lt/guide/atsisiuntimas-eksportas-v2.png)

1. Skirtukai **Parsisiuntimas** ir **API endpoint**.
2. **Eksporto formatas** — iš pradžių pasirinktas *JSON*.
3. **Apimtis** — **Visi duomenys** arba **Išfiltruoti duomenys**; skliaustuose — eilučių skaičius.
4. Mygtukas **Parsisiųsti**.

## Formatai [#formatai]

| Formatas    | Kada rinktis                                                                                                                                                         |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **CSV**     | Universaliausias. Atsidaro su *Excel*, *LibreOffice*, *Google Sheets*.                                                                                               |
| **XLSX**    | *Excel* darbaknygė — atsidaro tiesiogiai *Microsoft Excel* programoje. Ribojama iki 1 000 000 eilučių: didesnes lenteles išfiltruokite arba rinkitės CSV ar Parquet. |
| **JSON**    | Kai duomenis apdorosite programa ar scenarijumi.                                                                                                                     |
| **NDJSON**  | Eilutėmis atskirtas JSON — po vieną įrašą eilutėje; patogu srautiniam apdorojimui ar dideliems failams skaityti po eilutę.                                           |
| **Parquet** | Dideliems kiekiams ir analizei su *Python*, *R* ar duomenų įrankiais.                                                                                                |

Iš pradžių pasirinktas **JSON**. Jei duomenis norite atsidaryti skaičiuoklėje, rinkitės **CSV** arba **XLSX**.

## Failo parsisiuntimas [#failo-parsisiuntimas]

<Steps>
  <Step>
    ### Atverkite eksportą [#atverkite-eksportą]

    Lentelės antraštėje spustelėkite **Eksportuoti**. Atsivers langas **Eksportuoti rinkinį** su skirtuku **Parsisiuntimas**.
  </Step>

  <Step>
    ### Pasirinkite formatą [#pasirinkite-formatą]

    Sąraše **Eksporto formatas** pasirinkite *JSON*, *NDJSON*, *CSV*, *Parquet* arba *XLSX* (žr. lentelę aukščiau).
  </Step>

  <Step>
    ### Pasirinkite apimtį [#pasirinkite-apimtį]

    Iš pradžių pažymėta **Visi duomenys**. Jei lentelėje pritaikėte [filtrus](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table#eilučių-filtrai) ir norite tik atrinktų eilučių, pažymėkite **Išfiltruoti duomenys** — kitaip faile bus visos eilutės.
  </Step>

  <Step>
    ### Parsisiųskite [#parsisiųskite]

    Spustelėkite **Parsisiųsti** — failas bus išsaugotas jūsų kompiuteryje.
  </Step>
</Steps>

## Gavimas per API [#gavimas-per-api]

Tame pačiame lange skirtukas **API endpoint** parodo paruoštą užklausą, kurią galima nukopijuoti ir paleisti savo kompiuteryje:

![Skirtukas API endpoint, pažymėta 1–4: 1 kalbos pasirinkimas cURL arba Python; 2 paruošta užklausa į api.dataportal.gov.lt su limit ir offset; 3 apimtis — pažymėta Išfiltruoti duomenys (13 eilučių); 4 mygtukas Kopijuoti](https://guides.dataportal.gov.lt/guide/atsisiuntimas-api.png)

1. **Kalba** — *cURL* (komandinei eilutei) arba *Python* (su biblioteka `requests`).
2. **Užklausa** — adresas ir užklausos turinys.
3. **Apimtis** — pažymėjus **Išfiltruoti duomenys**, lentelės filtrai įrašomi į užklausą.
4. **Kopijuoti** — nukopijuoja užklausą.

Pavyzdžiui, rinkinio „Darbuotojų, finansuojamų iš biudžetų, bruto darbo užmokestis (mėnesinis) | Apskritys" užklausa, kai lentelėje palikti tik 2024 metai:

```bash
curl -X POST "https://api.dataportal.gov.lt/namespaces/188600177/tables/S3R640_M3060807_1_lt/query" \
  -H "Content-Type: application/json" \
  -d '{
  "limit": 24,
  "offset": 0,
  "filter": "laikotarpis._co=2024"
}'
```

* `188600177` — teikėjo kodas, `S3R640_M3060807_1_lt` — lentelės pavadinimas (galūnė `_lt` arba `_en` nurodo kalbą).
* `filter` — lentelėje pritaikyti filtrai; ši eilutė atsiranda tik pažymėjus **Išfiltruoti duomenys**. Joje naudojami stulpelių API pavadinimai, kurie skiriasi pagal kalbą: lietuviškoje lentelėje `laikotarpis`, angliškoje — `time_period`.
* `limit` ir `offset` — kiek eilučių grąžinti ir nuo kurios pradėti.

<Callout title="Užklausa grąžina tik vieną puslapį">
  Paruoštoje užklausoje `"limit": 24` — tiek eilučių, kiek rodo vienas lentelės puslapis. Atsakymo laukas `total` nurodo, kiek eilučių yra iš viso (šiame pavyzdyje 13). Norėdami gauti visas, padidinkite `limit` (pavyzdžiui, iki `1000`) arba siųskite kelias užklausas, didindami `offset`. Be `limit` API grąžina 100 eilučių.
</Callout>

Atsakymas — JSON: eilutės lauke `data` (stulpeliai vadinami [API pavadinimais](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table#struktūra), pavyzdžiui, `laikotarpis`), taip pat laukai `total`, `total_pages` ir `current_page`.

<Tips>
  * **Reguliariam naudojimui rinkitės API.** Visos užklausų galimybės — filtravimas, rikiavimas, stulpelių atranka ir puslapiavimas — aprašytos [Duomenų API dokumentacijoje](https://guides.dataportal.gov.lt/lt/docs/api).
</Tips>


# Klasifikatoriai (https://guides.dataportal.gov.lt/lt/docs/guide/classifiers)



<Callout title="Prieinama nuo 2026 m. spalio 1 d.">
  Ši portalo skiltis pradės veikti nuo 2026 m. spalio 1 d. Iki tol pateikta informacija gali keistis.
</Callout>

Klasifikatoriai — tai standartizuoti kodų ir reikšmių sąrašai, kuriais remiasi duomenų rinkiniai (pavyzdžiui, EVRK 2.1 – ekonominės veiklos rūšių klasifikatorius).

## Ką bus galima daryti [#ką-bus-galima-daryti]

* Peržiūrėti nacionalinių ir tarptautinių klasifikatorių katalogą.
* Atsidaryti konkretų klasifikatorių ir naršyti jo kodus bei reikšmes.

*Išsamios instrukcijos bus papildytos skilčiai pradėjus veikti.*


# Naujienos ir įžvalgos (https://guides.dataportal.gov.lt/lt/docs/guide/news)



Meniu **Naujienos** sujungia tris skiltis. Kiekviena atsako į kitą klausimą:

![Atvertas meniu Naujienos, pažymėta 1–3: 1 Kalendorius, 2 Informaciniai pranešimai, 3 Duomenų įžvalgos](https://guides.dataportal.gov.lt/guide/naujienos.png)

1. **Kalendorius** — *kada* bus paskelbti ar atnaujinti duomenys.
2. **Informaciniai pranešimai** — *kas nauja*, paaiškinta žodžiais, su grafikais ir lentelėmis.
3. **Duomenų įžvalgos** — *ką skaičiai reiškia*: trumpas analitinis komentaras apie naujausius rodiklius.

<Cards>
  <Card title="Kalendorius" href="https://guides.dataportal.gov.lt/lt/docs/guide/news/calendar" description="Leidybos tvarkaraštis: kada atsinaujins konkretus rinkinys, su filtrais ir įrašo eksportu į savo kalendorių." />

  <Card title="Informaciniai pranešimai" href="https://guides.dataportal.gov.lt/lt/docs/guide/news/reports" description="Pranešimai, lydintys naują statistiką: sąrašas, filtrai, pranešimo puslapis ir PDF eksportas." />

  <Card title="Duomenų įžvalgos" href="https://guides.dataportal.gov.lt/lt/docs/guide/news/insights" description="Analitiniai komentarai apie naujausius rodiklius — skaitomi iškart sąraše." />
</Cards>

## Kas bendra visoms trims skiltims [#kas-bendra-visoms-trims-skiltims]

Visos trys skiltys sudarytos vienodai, todėl išmokus vieną, kitos jau pažįstamos:

* **Paieška pagal žodį** — laukas virš sąrašo. Paieškos lauke nurodoma, kiek įrašų skiltyje yra iš viso.
* **Datų intervalas** — laukai **Data nuo** ir **Data iki**, veikiantys paspaudus **Ieškoti**.
* **Temos filtras** — tos pačios 13 [duomenų temų](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data) kaip ir kataloge.
* **Rikiavimas** — mygtukas **Naujausi** viršuje dešinėje.
* **Puslapiavimas** — po 24 įrašus puslapyje; virš sąrašo rodoma, kuri dalis pateikta (pavyzdžiui, „Rodoma 1–24 iš 4 085").

<Callout title="Filtrai išlieka nuorodoje">
  Pasirinkti filtrai įrašomi į adresą. Nukopijavę adresą iš naršyklės, išsaugosite arba galėsite persiųsti kolegai tą patį rodinį — pavyzdžiui, vienos temos kalendorių.
</Callout>

<Tips>
  * **Nenorite tikrinti patys?** [Prenumeruokite](https://guides.dataportal.gov.lt/lt/docs/guide/subscription) — apie pasirinktos temos atnaujinimus praneš el. paštu.
  * Kalendoriaus įrašai susieti su rinkiniais: iš įrašo galima iškart pereiti į [rinkinio puslapį](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page).
</Tips>


# Kalendorius (https://guides.dataportal.gov.lt/lt/docs/guide/news/calendar)



[Kalendorius](https://dataportal.gov.lt/lt/calendar) rodo, **kada** portale pasirodys nauji ar atnaujinti duomenys. Jame kaupiami ne tik oficialiosios statistikos leidimai, bet ir atvirų duomenų atnaujinimai, klasifikatorių pakeitimai, leidiniai bei panaudojimo atvejai — iš viso daugiau kaip keturi tūkstančiai įrašų.

![Duomenų leidybos kalendorius, pažymėta 1–4: 1 paieška; 2 laukai Data nuo ir Data iki su mygtuku Ieškoti; 3 rikiavimas Naujausi ir eilutė „Rodoma 1–24 iš …“; 4 vienas įrašas po dienos antrašte](https://guides.dataportal.gov.lt/guide/kalendorius.png)

1. **Paieška** — žodis iš rodiklio ar leidinio pavadinimo. Užuominoje nurodytas bendras įrašų skaičius.
2. **Datų intervalas** — laukai **Data nuo** ir **Data iki**; pritaikomi mygtuku **Ieškoti**.
3. **Rikiavimas** — **Naujausi**; apsuka eiliškumą. Kairėje rodoma, kuri dalis pateikta („Rodoma 1–24 iš …").
4. **Įrašas** — vienas leidimas. Įrašai sugrupuoti pagal dieną: antraštė (pavyzdžiui, **2026 m. rugsėjo 24 d.**) atskiria kiekvieną datą.

Kalendoriuje yra ir jau įvykusių, ir būsimų leidimų. Dar nepaskelbti įrašai pažymėti oranžine žyma **Nepaskelbta** ir turi kalendoriaus ženkliuką.

## Kaip skaityti įrašą [#kaip-skaityti-įrašą]

![Vienas nepaskelbtas kalendoriaus įrašas, pažymėta 1–7: 1 įvykio tipo žyma (Duomenų atnaujinimas); 2 publikacijos tipo žymos (Oficialioji statistika, Nedarbas); 3 pavadinimas; 4 oranžinė žyma Nepaskelbta; 5 data, laikas 09:00 ir teikėjas; 6 pjūvis ir laikotarpis (Amžius | Lytis, 2026M11); 7 kalendoriaus ženkliukas .ics failui atsisiųsti](https://guides.dataportal.gov.lt/guide/kalendoriaus-irasas.png)

Paveiksle — dar nepaskelbtas įrašas, todėl matyti visos septynios dalys.

1. **Įvykio tipo žyma** — ką portalas darys tą dieną, pavyzdžiui *Duomenų atnaujinimas*.
2. **Publikacijos tipo žyma** — kokio pobūdžio turinys tai bus, pavyzdžiui *Oficialioji statistika*. Žymų gali būti kelios, įskaitant sritį ( *Nedarbas*).
3. **Pavadinimas** — rodiklio ar leidinio pavadinimas.
4. **Žyma „Nepaskelbta"** — oranžinė žyma rodo, kad leidybos laikas dar neatėjo. Paskelbtuose įrašuose jos nebūna.
5. **Data, laikas ir teikėjas** — tiksli paskelbimo diena, valanda (paprastai **09:00**) ir institucija, dažniausiai *Valstybės duomenų agentūra*.
6. **Susietas pjūvis ir laikotarpis** — kuris rinkinio pjūvis bus atnaujintas ( *Amžius | Lytis*) ir už kurį laikotarpį ( *2026M11*). Paskelbtuose įrašuose tai nuoroda į [rinkinio puslapį](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page); pjūvių gali būti keli.
7. **Kalendoriaus ženkliukas** — atsisiunčia įrašą `.ics` formatu. Rodomas **tik nepaskelbtiems** įrašams.

<Callout title="Įtraukite leidybos datą į savo kalendorių">
  Kalendoriaus ženkliukas rodomas tik prie dar nepaskelbtų įrašų — jau paskelbto leidimo į kalendorių dėti nėra ko. Jis atsisiunčia `.ics` failą, pavadintą pagal rodiklį (pavyzdžiui, `butiniausiu-prekiu-ir-paslaugu-kainu-pokyciai.ics`). Atvėrus failą, leidybos data atsiranda jūsų kalendoriaus programoje — Outlook, Google Calendar ar kitoje — kartu su priminimu.

  Būsimus įrašus greičiausia surasti lauke **Data nuo** nurodžius rytdienos ar vėlesnę datą ir paspaudus **Ieškoti**.
</Callout>

## Filtrai [#filtrai]

Filtrų skydelyje yra keturios grupės. Galima žymėti kelias reikšmes vienoje grupėje ir derinti grupes tarpusavyje.

![Kalendoriaus filtrų skydelis su keturiomis suskleistomis grupėmis, pažymėta 1–4: Įvykio tipo žyma, Publikacijos tipas, Organizacijos, Tema](https://guides.dataportal.gov.lt/guide/kalendoriaus-filtrai.png)

1. **Įvykio tipo žyma** — ką portalas darys tą dieną.
2. **Publikacijos tipas** — kokio pobūdžio turinys bus paskelbtas.
3. **Organizacijos** — duomenis skelbianti institucija.
4. **Tema** — duomenų sritis.

Kiekvienos grupės reikšmės — žemiau. Paveiksle grupės suskleistos, kad matytųsi visos keturios; portale jos atidarytos.

<Accordions type="single">
  <Accordion title="Įvykio tipo žyma">
    Kas nutiks nurodytą dieną. Penkios reikšmės:

    * **Duomenų atnaujinimas** — esamas rinkinys papildomas naujais duomenimis.
    * **Duomenų paskelbimas** — skelbiamas naujas rinkinys.
    * **Informacijos skelbimas** — skelbiamas pranešimas, leidinys ar kitas tekstas.
    * **Panaudojimo atvejo atnaujinimas** — atnaujinamas [panaudojimo atvejis](https://guides.dataportal.gov.lt/lt/docs/guide/use-cases).
    * **Panaudojimo atvejo paskelbimas** — skelbiamas naujas panaudojimo atvejis.
  </Accordion>

  <Accordion title="Publikacijos tipas">
    Turinio pobūdis. Aštuoniolika reikšmių: *Ataskaita / Analizė*, *Atviri duomenys*, *Duomenų aplikacija*, *Eksperimentinė statistika*, *Geoerdviniai duomenys*, *Infografikas*, *Informacinis pranešimas*, *Kodų sąrašas*, *Leidinys*, *Mokslo publikacija*, *Nacionalinis klasifikatorius*, *Oficialioji statistika*, *Straipsnis*, *Švieslentė*, *Taksonomija*, *Tarptautinis klasifikatorius*, *Užsakomi valstybės duomenys* ir *Žemėlapis / atlasas*.

    Grupė turi savo paieškos laukelį — ilgo sąrašo nebūtina slinkti.
  </Accordion>

  <Accordion title="Organizacijos">
    Duomenis skelbianti institucija. Sąraše beveik keturi šimtai įstaigų — ministerijos, savivaldybės, agentūros ir valstybės valdomos įmonės. Grupė taip pat turi paieškos laukelį, todėl greičiausia įrašyti pavadinimo dalį.
  </Accordion>

  <Accordion title="Tema">
    Tos pačios 13 duomenų temų kaip ir [kataloge](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data) — nuo *Aplinkos* ir *Ekonomikos ir finansų* iki *Sveikatos* bei *Transporto ir ryšių*.
  </Accordion>
</Accordions>

## Paieška pagal laikotarpį [#paieška-pagal-laikotarpį]

<Steps>
  <Step>
    ### Įrašykite žodį [#įrašykite-žodį]

    Paieškos laukelyje įrašykite rodiklio ar leidinio pavadinimo dalį.
  </Step>

  <Step>
    ### Nurodykite laikotarpį [#nurodykite-laikotarpį]

    Laukuose **Data nuo** ir **Data iki** pasirinkite intervalą — pavyzdžiui, artimiausią mėnesį ar ketvirtį.
  </Step>

  <Step>
    ### Paspauskite **Ieškoti** [#paspauskite-ieškoti]

    Datos pritaikomos tik paspaudus mygtuką. Filtrų skydelio žymos veikia iškart.
  </Step>
</Steps>

<Tips>
  * **Sekate vieną sritį?** Pažymėkite **Temą** ir **Įvykio tipo žymą** *Duomenų atnaujinimas* — matysite tik tos srities atnaujinimų grafiką, be pranešimų ir leidinių.
  * **Rengiate darbus pagal grafiką?** Iš įrašo pereikite į rinkinio puslapį ir pasižiūrėkite, kokį [pjūvį](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table) ir laikotarpį jis apima.
  * Datos ir laikai — Lietuvos laiku.
</Tips>


# Informaciniai pranešimai (https://guides.dataportal.gov.lt/lt/docs/guide/news/reports)



[Informaciniai pranešimai](https://dataportal.gov.lt/lt/news) — tekstai, kuriais Valstybės duomenų agentūra pristato ką tik paskelbtą statistiką: „Gyventojų sveikatos statistinio tyrimo rezultatai", „Situacijos darbo rinkoje apžvalga" ir panašiai. Skirtingai nei [duomenų įžvalgos](https://guides.dataportal.gov.lt/lt/docs/guide/news/insights), tai pilni straipsniai su grafikais, lentelėmis ir paaiškinimais.

![Informacinių pranešimų sąrašas, pažymėta 1–5: 1 filtras Tema; 2 paieška; 3 laukai Data nuo ir Data iki; 4 rikiavimas Naujausi; 5 pranešimo kortelė su nuotrauka, pavadinimu ir data](https://guides.dataportal.gov.lt/guide/pranesimai.png)

## Sąrašas ir filtrai [#sąrašas-ir-filtrai]

1. **Filtrai** — grupė **Tema** su tomis pačiomis 13 duomenų temų kaip [kataloge](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data).
2. **Paieška** — pavadinimo ar teksto dalis; užuominoje nurodytas bendras pranešimų skaičius.
3. **Datų intervalas** — **Data nuo** ir **Data iki**, pritaikomi mygtuku **Ieškoti**.
4. **Rikiavimas** — **Naujausi**.
5. **Pranešimo kortelė** — nuotrauka, pavadinimas ir paskelbimo data. Puslapių numeriai — sąrašo apačioje.

## Pranešimo puslapis [#pranešimo-puslapis]

![Informacinio pranešimo puslapio viršus, pažymėta 1–5: 1 naršymo kelias (Pagrindinis / Informaciniai pranešimai / pavadinimas); 2 paskelbimo data; 3 mygtukas Eksportuoti PDF; 4 nuorodos kopijavimo ženkliukas; 5 dalijimosi ženkliukas](https://guides.dataportal.gov.lt/guide/pranesimas.png)

1. **Naršymo kelias** — *Pagrindinis / Informaciniai pranešimai / pavadinimas*; greitas kelias atgal į sąrašą.
2. **Paskelbimo data**.
3. **Eksportuoti PDF** — parsisiunčia pranešimą PDF formatu su grafikais.
4. **Nuorodos ženkliukas** — nukopijuoja pranešimo adresą į iškarpinę.
5. **Dalijimosi ženkliukas** — pasiūlo pasidalyti pranešimu.

Toliau eina pavadinimas, iliustracija ir pats tekstas.

### Interaktyvūs grafikai [#interaktyvūs-grafikai]

Pranešimų grafikai nėra paveikslėliai — juos galima tyrinėti. Priklausomai nuo temos, po grafiku būna mygtukų, kuriais:

* įjungiamos ar išjungiamos atskiros eilutės (pavyzdžiui, **Labai gera ir gera**, **Vidutiniška**, **Bloga arba labai bloga**);
* perjungiami metai (**2014**, **2019**, **2025**);
* pasirenkama gyventojų grupė (**Iš viso**, **Moterys**, **Vyrai**).

Užvedus pelę ant grafiko, parodoma tikslią reikšmė.

<Callout type="info" title="Nuo pranešimo prie duomenų">
  Pranešimas paaiškina, ką rodo statistika, bet neleidžia jos perskaičiuoti savaip. Jeigu reikia pačių skaičių — kitų pjūvių, ilgesnės laiko eilutės ar atsisiuntimo — ieškokite rinkinio [kataloge](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data) arba peržiūrėkite [rinkinio lentelę](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/table).
</Callout>

<Tips>
  * **Reikia pranešimo dokumentui?** Mygtukas **Eksportuoti PDF** parengia tvarkingą versiją su grafikais — nereikia daryti ekrano nuotraukų.
  * **Domina viena sritis?** Pažymėkite **Temą** ir išsaugokite adresą — grįžę matysite tik tos srities pranešimus.
  * Naujausius pranešimus taip pat rodo portalo pradžios puslapis, skiltis **Informaciniai pranešimai**.
</Tips>


# Duomenų įžvalgos (https://guides.dataportal.gov.lt/lt/docs/guide/news/insights)



[Duomenų įžvalgos](https://dataportal.gov.lt/lt/data-insights) — trumpi analitiniai komentarai apie naujausius oficialiosios statistikos rodiklius. Kiekvienas jų keliais sakiniais pasako, ką skaičiai rodo: kiek, kada ir kaip pasikeitė.

![Duomenų įžvalgų puslapis, pažymėta 1–4: 1 temų medis filtrų skydelyje; 2 paieška; 3 rikiavimas Naujausi ir rezultatų eilutė; 4 įžvalgos kortelė su visu tekstu](https://guides.dataportal.gov.lt/guide/izvalgos.png)

1. **Tema** — filtrų skydelyje. Temos sudėtos į medį: prie temos esanti rodyklė išskleidžia potemes, todėl galima susiaurinti tiksliau nei iki 13 pagrindinių sričių. Grupėje yra ir paieškos laukelis.
2. **Paieška** — žodis iš pavadinimo ar komentaro; užuominoje nurodyta, kiek įžvalgų yra iš viso.
3. **Rikiavimas** — **Naujausi**. Kairėje rodoma, kuri dalis pateikta („Rodoma 1–24 iš …"); puslapių numeriai — sąrašo apačioje. Laikotarpį nurodo laukai **Data nuo** ir **Data iki** su mygtuku **Ieškoti**.
4. **Įžvalgos kortelė** — visa įžvalga, skaitoma iškart sąraše.

## Kaip skaityti įžvalgą [#kaip-skaityti-įžvalgą]

Įžvalgos skaitomos sąraše — atskiro puslapio jos neturi, todėl niekur eiti nereikia. Kortelėje yra:

* **Temos žyma** (violetinė) — sritis, pavyzdžiui *Mokslas ir technologijos* ar *Ekonomika ir finansai*.
* **Pavadinimas** su laikotarpiu — pavyzdžiui, „Moksliniai tyrimai ir eksperimentinė veikla, 2025 m.".
* **Paskelbimo data**.
* **Komentaras*&#x2A; — vienas ar du sakiniai su svarbiausiais skaičiais. Pavyzdžiui: &#x2A;„Išankstiniais duomenimis, moksliniams tyrimams ir eksperimentinei plėtrai (MTEP) 2025 m. išleista 935,7 mln. EUR. MTEP išlaidos sudarė 1,11 proc. bendrojo vidaus produkto (BVP)."*

Įrašai sugrupuoti pagal dieną, naujausi — viršuje.

## Kuo skiriasi nuo informacinių pranešimų [#kuo-skiriasi-nuo-informacinių-pranešimų]

|              | Duomenų įžvalgos                 | [Informaciniai pranešimai](https://guides.dataportal.gov.lt/lt/docs/guide/news/reports) |
| ------------ | -------------------------------- | ------------------------------------------------------- |
| Apimtis      | Vienas–du sakiniai               | Pilnas straipsnis                                       |
| Kur skaitoma | Iškart sąraše                    | Atskirame puslapyje                                     |
| Grafikai     | Nėra                             | Interaktyvūs grafikai ir lentelės                       |
| PDF          | Nėra                             | **Eksportuoti PDF**                                     |
| Kam patogu   | Greitai apžvelgti, kas pasikeitė | Suprasti kontekstą ir detales                           |

<Callout type="info" title="Nuo įžvalgos prie duomenų">
  Įžvalgoje pateikiamas skaičius — tai suvestinė reikšmė. Jeigu reikia laiko eilutės, kitų pjūvių ar atsisiuntimo, rinkinio ieškokite [kataloge](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data) — pravers ir [išmanioji paieška](https://guides.dataportal.gov.lt/lt/docs/guide/smart-search), į kurią galima įrašyti visą klausimą.
</Callout>

<Tips>
  * **Norite sekti vieną sritį?** Pažymėkite temą ir išsaugokite naršyklės adresą — jame lieka ir filtras.
  * Naujausias įžvalgas rodo ir portalo pradžios puslapis.
  * Jeigu įžvalgoje minimas rodiklis jus domina reguliariai, pažiūrėkite, kada jis atnaujinamas, [kalendoriuje](https://guides.dataportal.gov.lt/lt/docs/guide/news/calendar).
</Tips>


# Duomenų panaudojimo atvejai (https://guides.dataportal.gov.lt/lt/docs/guide/use-cases)



Panaudojimo atvejai (portale jie dar vadinami **duomenų produktais**) rodo, kaip portale skelbiami duomenys pritaikomi praktikoje — švieslentėse, ataskaitose, žemėlapiuose ar leidiniuose. Šiuo metu visi atvejai yra interaktyvios **švieslentės**.

## Kur rasti [#kur-rasti]

* **Meniu Duomenys ir statistika → Panaudojimo atvejai.** Čia yra trys punktai:
  * **Peržiūrėti katalogą** — visų atvejų sąrašas (aprašytas žemiau).
  * **Apie duomenų panaudojimo atvejus** — [kas yra duomenų produktai](https://dataportal.gov.lt/lt/about-data-products), kam jie skirti, ir dažniausi klausimai.
  * **Darnaus vystymosi rodikliai (SDG)** — atskira svetainė [dvr.stat.gov.lt](https://dvr.stat.gov.lt/).
* **[Išmanioji paieška](https://guides.dataportal.gov.lt/lt/docs/guide/smart-search)** — pažymėkite filtrą **Duomenų panaudojimo atvejai**.
* **[Rinkinio puslapis](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page)** — skirtukas **Panaudojimo atvejai** (kol kas dažniausiai tuščias).

## Atvejų sąrašas [#atvejų-sąrašas]

![Panaudojimo atvejų sąrašas, pažymėta 1–5: 1 temų medis Duomenų tema; 2 filtras Duomenų panaudojimo tipas; 3 paieška; 4 rikiavimas; 5 atvejo kortelė su peržiūros vaizdu, pavadinimu, tipu, teikėju, data, skaitikliais ir „+6“ raktažodžiais](https://guides.dataportal.gov.lt/guide/atvejai-sarasas.png)

1. **Duomenų tema** — temos išdėstytos medžiu: rodyklė šalia temos išskleidžia jos potemes. Grupė turi paieškos laukelį.
2. **Duomenų panaudojimo tipas** — *Ataskaita / analizė*, *Duomenų aplikacija*, *Infografikas*, *Informacinis pranešimas*, *Leidinys*, *Mokslo publikacija*, *Straipsnis*, *Švieslentė*, *Žemėlapis / atlasas* ir *Kita*.
3. **Paieška** tarp visų atvejų.
4. **Rikiavimas** — *Aktualiausi*, *Naujausi*, *Seniausi*, *Pavadinimas A-z* arba *Pavadinimas Z-a*.
5. **Atvejo kortelė** — peržiūros vaizdas, pavadinimas, tipas, teikėjas, paskelbimo data ir skaitikliai. „+6" — dar šeši raktažodžiai: užveskite pelę, kad juos pamatytumėte.

## Atvejo puslapis [#atvejo-puslapis]

Spustelėjus kortelę, atsiveria atvejo puslapis:

![Švieslentės panaudojimo atvejo puslapis, pažymėta 1–8: 1 tipas (Švieslentė); 2 pavadinimas; 3 datos su pamėgimų, atsisiuntimų ir peržiūrų skaičiais; 4 aprašas; 5 mygtukas Peržiūrėti; 6 Kopijuoti nuorodą, Pasidalinti ir Grįžtamojo ryšio forma; 7 peržiūros vaizdas; 8 skirtukai (Metaduomenys, Pateikties informacija, Susiję duomenų rinkiniai, Šaltiniai)](https://guides.dataportal.gov.lt/guide/atvejis-puslapis.png)

1. **Tipas** — pavyzdžiui, *Švieslentė*.
2. **Pavadinimas.**
3. **Paskelbimo ir atnaujinimo datos** bei pamėgimų, atsisiuntimų ir peržiūrų skaičius.
4. **Aprašas** — ką atvejis rodo ir iš kur gauti duomenys.
5. **Peržiūrėti** — atveria patį produktą (žr. žemiau).
6. **Kopijuoti nuorodą**, **Pasidalinti** ir **Grįžtamojo ryšio forma** — tokie pat kaip [rinkinio puslapyje](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/dataset-page#cituoti-pasidalyti-pranešti).
7. **Peržiūros vaizdas** — kaip atrodo produktas.
8. **Skirtukai** — aprašyti žemiau.

| Skirtukas                    | Kas jame                                                                                                                                                 |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Metaduomenys**             | Kūrėjas ir teikėjas, identifikatorius (pavyzdžiui, `DR000005`), raktažodžiai, tema, prieigos teisės, geografinė aprėptis, paskelbimo ir pakeitimo datos. |
| **Pateikties informacija**   | Kaip atvejis pateikiamas: formatas (švieslentėms — *HTML*), prieigos nuoroda ir **licencija**.                                                           |
| **Susiję duomenų rinkiniai** | Rinkiniai, iš kurių sudarytas atvejis.                                                                                                                   |
| **Šaltiniai**                | Iš kur duomenys gauti.                                                                                                                                   |

Po skirtukais — **Panaudojimo atvejai iš to paties kūrėjo**.

<Callout type="info" title="Ne visi skirtukai užpildyti">
  Šiuo metu skirtukai *Susiję duomenų rinkiniai* ir *Šaltiniai* dažniausiai rodo „Duomenų nėra" — informacija dar nepateikta.
</Callout>

## Produkto peržiūra [#produkto-peržiūra]

Mygtukas **Peržiūrėti** atveria patį produktą. Kur jis atsivers, priklauso nuo produkto: švieslentės šiuo metu atveriamos pačiame portale, atskirame puslapyje (jo adresas baigiasi `/dashboard`), o kiti produktai — pavyzdžiui, leidinys ar aplikacija — gali būti išorinėje svetainėje.

![Portale atverta ŽPV skiepijimo stebėsenos švieslentė: filtrai (ataskaitinė data, amžiaus grupė, lytis, apskritis), apskričių žemėlapis pagal paskiepytų dalį ir apskričių lentelė, palyginta su visa Lietuva](https://guides.dataportal.gov.lt/guide/atvejis-svieslente.png)

Švieslentė interaktyvi: filtrai, žemėlapiai ir lentelės priklauso pačiai švieslentei, todėl kiekviena atrodo savaip. Po ja — juosta **Daugiau švieslenčių** su kitais atvejais. Jei vietoj švieslentės rodoma „Nepavyko įkelti turinio", spustelėkite **Atnaujinti**.

<Tips>
  * **Norite pasidalyti švieslente?** Nukopijuokite atvejo puslapio nuorodą mygtuku **Kopijuoti nuorodą**.
  * **Reikia pačių skaičių?** Švieslentėje rodomus rodiklius susiraskite [kataloge](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data) arba [išmaniąja paieška](https://guides.dataportal.gov.lt/lt/docs/guide/smart-search) — ten juos galima [atsisiųsti](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading).
</Tips>


# Paslaugos (https://guides.dataportal.gov.lt/lt/docs/guide/services)



<Callout title="Prieinama nuo 2026 m. spalio 1 d.">
  Skiltis jau matoma portale, tačiau oficialiai pradės veikti nuo 2026 m. spalio 1 d. Iki tol pateikta informacija gali keistis. Šiuo metu internetu galima užsakyti tik **Duomenų gavimo** paslaugą.
</Callout>

Skiltyje [**Paslaugos**](https://dataportal.gov.lt/lt/services) (portalo meniu viršuje) Valstybės duomenų agentūra (VDA) siūlo paslaugas — nuo duomenų gavimo iki analitinės infrastruktūros, mokymų ir duomenų atvėrimo.

## Paslaugų sąrašas [#paslaugų-sąrašas]

![Paslaugų puslapis, pažymėta 1–4: 1 grupė Paslaugos visiems (Duomenų gavimas); 2 grupė Paslaugos viešajam sektoriui (keturios paslaugos); 3 pasirinktos paslaugos kortelė su skiltimis Kam skirta? ir Ką gaunate?; 4 mygtukas Pradėti užsakymą](https://guides.dataportal.gov.lt/guide/paslaugu-sarasas.png)

1. **Paslaugos visiems** — duomenų gavimas. Užsakyti gali fiziniai ir juridiniai asmenys.
2. **Paslaugos viešajam sektoriui** — keturios paslaugos, skirtos tik institucijoms.
3. **Paslaugos kortelė** — *Kam skirta?* ir *Ką gaunate?*
4. **Pradėti užsakymą** — kol kas aktyvus tik duomenų gavimo paslaugai; kitų paslaugų mygtukai dar neaktyvūs.

| Paslauga                                           | Kam skirta                                                  | Ką gaunate                                                                                                                                                 |
| -------------------------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Duomenų gavimas**                                | Institucijoms, tyrėjams ir kitiems naudotojams              | Registrų ir informacinių sistemų duomenis, apdorotą statistinę informaciją, galimybę pakartotinai naudoti sveikatos duomenis teisės aktų nustatyta tvarka. |
| **Skaitmeninė duomenų infrastruktūra**             | Tik viešajam sektoriui                                      | Savo informacinę sistemą ar jos dalį Valstybės duomenų valdysenos platformoje, analitinę darbo aplinką ir įrankius be atskiros infrastruktūros.            |
| **Prieiga prie Valstybės duomenų ežero ir mokymų** | Tik viešajam sektoriui — darbuotojams ir analitikams        | Parengtus strateginius rodiklius ir švieslentes, analitinius įrankius ir praktinius mokymus.                                                               |
| **Centralizuotas jūsų valdomų duomenų atvėrimas**  | Tik viešajam sektoriui — duomenis valdančioms institucijoms | VDA inventorizuoja, sutvarko ir paskelbia jūsų atvirus duomenis su metaduomenimis ir automatiniu atnaujinimu.                                              |
| **Užsakomasis darbas**                             | Tik viešajam sektoriui                                      | Mokamus statistinius tyrimus, metodikas, analizę ar vertinimus pagal sutartą apimtį ir terminus.                                                           |

## Kaip užsakyti [#kaip-užsakyti]

<Steps>
  <Step>
    ### Apibrėžkite poreikį [#apibrėžkite-poreikį]

    Nuspręskite, kokio rezultato reikia (duomenų, analizės, prieigos ar sprendimo), kam jis bus naudojamas ir kokia numatoma apimtis. Prireikus pasikonsultuokite su VDA specialistais — tai sutrumpins derinimą.
  </Step>

  <Step>
    ### Pateikite paraišką [#pateikite-paraišką]

    Spustelėkite **Pradėti užsakymą** ir prisijunkite:

    ![Prisijungimo pasirinkimas prieš užsakant paslaugą, pažymėta 1–2: 1 El. valdžios vartai (el. bankininkystė, Smart-ID, mobilusis parašas); 2 Portalo paskyra ne ES / EEE šalių piliečiams](https://guides.dataportal.gov.lt/guide/paslaugos-prisijungimas.png)

    1. **El. valdžios vartai** — per el. bankininkystę, „Smart-ID" ar mobilųjį parašą.
    2. **Portalo paskyra** — ne ES / EEE šalių piliečiams.

    Paraiškos pateikimas ir vertinimas nemokami. VDA įvertina paraišką, patikslina įgyvendinimo būdus ir informuoja apie terminus bei preliminarias sąnaudas.
  </Step>

  <Step>
    ### Suderinkite ir apmokėkite [#suderinkite-ir-apmokėkite]

    Tikslinama apimtis, sąlygos ir dokumentai, pateikiama galutinė kaina. Darbai pradedami tik po galutinio suderinimo.
  </Step>

  <Step>
    ### Paslauga įgyvendinama [#paslauga-įgyvendinama]

    VDA parengia, sutvarko ar nuasmenina duomenis, suteikia prieigas ar atlieka kitus sutartus darbus.
  </Step>

  <Step>
    ### Gaukite rezultatą [#gaukite-rezultatą]

    Jums suteikiama prieiga prie duomenų ar analitinės aplinkos arba pateikiamas galutinis produktas — duomenų rinkinys, ataskaita ar rodikliai.
  </Step>
</Steps>

Paslaugų teikimą reglamentuoja teisės aktai, [susiję su statistinių ir valstybės duomenų teikimu](https://vda.lrv.lt/lt/teisine-informacija/teises-aktai/teises-aktai-pagal-sritis/teises-aktai-reglamentuojantys-statistiniu-duomenu-ir-valstybes-duomenu-teikima/) bei [sveikatos duomenų teikimu](https://vda.lrv.lt/lt/teisine-informacija/teises-aktai/teises-aktai-pagal-sritis/teises-aktai-reglamentuojantys-sveikatos-duomenu-tvarkyma/), ir [asmens duomenų tvarkymo taisyklės](https://vda.lrv.lt/lt/asmens-duomenu-apsauga/asmens-duomenu-apsauga-vda/informacija-apie-asmens-duomenu-tvarkyma/).

## Dažniausi klausimai [#dažniausi-klausimai]

<Accordions type="single">
  <Accordion title="Ar reikia pildyti paraišką?">
    Taip. Statistinei informacijai, valstybės duomenims, konfidencialiems statistiniams duomenims mokslo tikslams ar sveikatos duomenų pakartotiniam naudojimui pateikiamas nustatytos formos prašymas per užsakymo modulį **Duomenų gavimas**.
  </Accordion>

  <Accordion title="Kokius dokumentus reikia pateikti?">
    Prašant tik statistinių duomenų — jokių, pakanka prašymo. Prašant pirminių valstybės duomenų (kopijų), pridedami dokumentai, pagrindžiantys teisę juos gauti ir naudojimo tikslą. Jautresniems duomenims gali būti pasirašomi įsipareigojimai dėl duomenų saugos, kartais prašoma poveikio duomenų apsaugai vertinimo.
  </Accordion>

  <Accordion title="Kas gali teikti paraišką?">
    Fizinis arba juridinis asmuo, jei tikslas teisėtas ir yra teisinis pagrindas gauti duomenis. Konfidencialių statistinių duomenų mokslo tikslams prašymą teikia mokslo ir studijų institucijai atstovaujantis asmuo, o duomenys teikiami pagal sutartį su ta institucija.
  </Accordion>

  <Accordion title="Ar duomenų gavimas mokamas?">
    Už pačius duomenis paprastai mokėti nereikia. Mokama tik už parengimo ir apdorojimo darbus, kai jų reikia — pavyzdžiui, atranką, sujungimą, pažymas ar analizę.
  </Accordion>

  <Accordion title="Ar mokama už konfidencialius statistinius duomenis mokslo tikslams?">
    Taip, bet tik už duomenų parengimą ir administravimą, ne už pačius duomenis.
  </Accordion>

  <Accordion title="Ar mokamas sveikatos duomenų pakartotinio naudojimo leidimas?">
    Taip. Mokestį sudaro rinkliava už paraiškos nagrinėjimą, duomenų paruošimo (surinkimo, nuasmeninimo, programavimo) kaina ir saugios aplinkos išteklių naudojimas, jei duomenys teikiami joje.
  </Accordion>

  <Accordion title="Ar sudaromos duomenų teikimo sutartys?">
    Valstybės duomenims — paprastai ne: suderinamas oficialus raštas su duomenų apimtimi, tikslu ir atsakomybėmis. Konfidencialūs statistiniai duomenys mokslo tikslams visada teikiami pagal sutartį su mokslo įstaiga.
  </Accordion>

  <Accordion title="Ar VDA dalyvauja viešuosiuose pirkimuose?">
    Ne — VDA nėra viešųjų pirkimų subjektas. Sprendimams, susijusiems su valstybės duomenimis, gali būti užsakomos centralizuotos VDA duomenų valdymo paslaugos.
  </Accordion>

  <Accordion title="Kaip prisijungti prie „Savivaldos DataLab“?">
    Platforma skirta savivaldybių administracijoms ir susijusioms institucijoms. Savivaldybės darbuotojas kreipiasi į savo savivaldybės koordinatorių, kuris pateikia prašymą VDA. Kitos institucijos ir asmenys prašymą teikia per modulį **Duomenų gavimas**, aiškiai nurodę tikslą.
  </Accordion>
</Accordions>

<Tips>
  * **Ieškote viešų duomenų?** Pirmiausia pažiūrėkite [kataloge](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data) — atvirus duomenis galima [atsisiųsti](https://guides.dataportal.gov.lt/lt/docs/guide/browsing-data/downloading) be jokio užsakymo.
  * **Nežinote, kurios paslaugos reikia?** Prieš teikdami paraišką pasikonsultuokite su VDA specialistais.
</Tips>


# Prisijungimas (https://guides.dataportal.gov.lt/lt/docs/guide/account/sign-in)



## Kaip prisijungti [#kaip-prisijungti]

<Steps>
  <Step>
    ### Spustelėkite „Prisijungti" [#spustelėkite-prisijungti]

    Mygtukas **Prisijungti** yra viršutiniame dešiniajame portalo kampe.

    ![Portalo antraštės dešinė dalis, pažymėta 1: mygtukas Prisijungti šalia paieškos](https://guides.dataportal.gov.lt/guide/prisijungimas-mygtukas.png)
  </Step>

  <Step>
    ### Pasirinkite prisijungimo būdą [#pasirinkite-prisijungimo-būdą]

    ![Prisijungimo būdo pasirinkimas „Prisijungimas per VIISP", pažymėta 1–2: 1 El. valdžios vartai (el. bankininkystė, Smart-ID, mobilusis parašas); 2 Portalo paskyra ne ES / EEE šalių piliečiams](https://guides.dataportal.gov.lt/guide/paslaugos-prisijungimas.png)

    1. **El. valdžios vartai** (VIISP) — per el. bankininkystę, „Smart-ID" ar mobilųjį parašą.
    2. **Portalo paskyra** — ne ES / EEE šalių piliečiams.
  </Step>

  <Step>
    ### Patvirtinkite tapatybę [#patvirtinkite-tapatybę]

    El. valdžios vartuose pasirinkite būdą ir prisijunkite įprastai. Po to būsite grąžinti į portalą.

    ![El. valdžios vartų prisijungimo puslapis, pažymėta 1–3: 1 skirtukas El. bankas su bankų sąrašu; 2 skirtukas El. parašas; 3 skirtukas Užsieniečiams](https://guides.dataportal.gov.lt/guide/prisijungimas-vartai.png)

    1. **El. bankas** — pasirinkite savo banką.
    2. **El. parašas** — „Smart-ID" arba mobilusis parašas.
    3. **Užsieniečiams** — užsienio šalių piliečiams.
  </Step>
</Steps>

Jei atsijungę (pavyzdžiui, pasibaigus sesijai) atversite paskyros puslapį, portalas pirmiausia paprašys prisijungti, o po to grąžins į tą patį puslapį.

## Pirmasis prisijungimas [#pirmasis-prisijungimas]

Pirmą kartą prisijungus portalas paprašo užbaigti profilį — tai du žingsniai. Vėliau jie nebekartojami: iš El. valdžios vartų grįšite tiesiai į portalą.

<Steps>
  <Step>
    ### Profilio informacija [#profilio-informacija]

    **Vardas** ir **Pavardė** perkeliami iš El. valdžios vartų — jų keisti negalima. Įrašykite **El. paštą** (privaloma) ir, jei norite, **Tel. numerį** su šalies kodu. Spustelėkite **Išsaugoti** — nurodytu adresu iškart išsiunčiamas patvirtinimo kodas.
  </Step>

  <Step>
    ### El. pašto patvirtinimas [#el-pašto-patvirtinimas]

    Laukelyje **Kodas** suveskite šešių simbolių kodą iš laiško ir spustelėkite **Tęsti**. Atsidarys jūsų paskyra.

    * Laiško nėra? Palaukite iki 5 minučių ir patikrinkite nepageidaujamų laiškų (*spam*) aplanką.
    * Kodas neteisingas arba nebegalioja? Spustelėkite **Siųsti kodą dar kartą**.
    * Suklydote rašydami el. paštą? Spustelėkite **Atgal** ir pataisykite adresą.
  </Step>
</Steps>

## Atsijungimas [#atsijungimas]

Spustelėkite savo vardą viršutiniame dešiniajame kampe ir pasirinkite **Atsijungti**.

## Dažniausi klausimai [#dažniausi-klausimai]

<Accordions type="single">
  <Accordion title="Kokius kontaktinius duomenis reikia užpildyti pirmą kartą jungiantis?">
    Privaloma įvesti el. pašto adresą. Telefono numeris — neprivalomas.
  </Accordion>

  <Accordion title="Kodėl reikia patvirtinti el. paštą?">
    Taip užtikrinama, kad nurodytas adresas galioja ir yra jums pasiekiamas. Patvirtinimo kodas išsiunčiamas iškart išsaugojus kontaktinius duomenis.
  </Accordion>

  <Accordion title="Per kiek laiko atkeliauja laiškas?">
    Iki 5 minučių. Jei laiško vis dar nėra, patikrinkite nepageidaujamų laiškų (*spam*) aplanką.
  </Accordion>

  <Accordion title="Ką daryti, jei kodas neteisingas arba nebegalioja?">
    Spustelėkite **Siųsti kodą dar kartą** — naujas kodas bus išsiųstas tuo pačiu adresu.
  </Accordion>

  <Accordion title="Ar kaskart prisijungiant reikia patvirtinti el. paštą?">
    Ne. Profilis pildomas ir el. paštas patvirtinamas tik pirmą kartą. Vėliau iš El. valdžios vartų grįšite tiesiai į portalą.
  </Accordion>
</Accordions>


# Paskyra (https://guides.dataportal.gov.lt/lt/docs/guide/account)



Naršyti ir atsisiųsti duomenis galima ir neprisijungus. Prisijungę galėsite **pamėgti** duomenų rinkinius, **išsaugoti** lenteles ir gauti **pranešimus** apie jų atnaujinimus, taip pat **užsakyti paslaugas** ir sekti jų mokėjimus. Kaip prisijungti — [Prisijungimas](https://guides.dataportal.gov.lt/lt/docs/guide/account/sign-in).

Į paskyrą pateksite spustelėję savo vardą viršutiniame dešiniajame kampe. Tame pačiame meniu yra ir **Atsijungti**. Paskyros puslapiuose skiltys išvardytos kairėje.

![Paskyros meniu ir skiltys, pažymėta 1–4 (asmens duomenys pavyzdiniai): 1 vardas viršutiniame dešiniajame kampe; 2 atvertas meniu su skiltimis ir Atsijungti; 3 skilčių sąrašas kairėje; 4 varpelis — Pranešimai](https://guides.dataportal.gov.lt/guide/paskyra-meniu.png)

1. **Jūsų vardas** — spustelėję atversite paskyros meniu.
2. **Paskyros meniu** — skiltys ir **Atsijungti**.
3. **Skilčių sąrašas** — rodomas kairėje visuose paskyros puslapiuose.
4. **Varpelis** — atveria **Pranešimus**.

## Skiltys [#skiltys]

<Cards>
  <Card title="Prisijungimas" href="https://guides.dataportal.gov.lt/lt/docs/guide/account/sign-in" description="Prisijungimas per El. valdžios vartus, pirmasis prisijungimas ir atsijungimas." />

  <Card title="Pamėgti ir išsaugoti duomenys" href="https://guides.dataportal.gov.lt/lt/docs/guide/account/saved-data" description="Pamėgti rinkiniai ir išsaugotos lentelės su aplankais, atnaujinimu ir laiškais." />

  <Card title="Pranešimai" href="https://guides.dataportal.gov.lt/lt/docs/guide/account/notifications" description="Portalo pranešimai ir el. laiškų nustatymai." />

  <Card title="Paslaugų užsakymai ir mokėjimai" href="https://guides.dataportal.gov.lt/lt/docs/guide/account/orders" description="Paraiškos, užsakymo forma ir mokėjimai už paslaugas." />

  <Card title="Profilis ir prisijungimų istorija" href="https://guides.dataportal.gov.lt/lt/docs/guide/account/profile" description="El. paštas, telefonas ir jūsų prisijungimų žurnalas." />
</Cards>


# Pamėgti ir išsaugoti duomenys (https://guides.dataportal.gov.lt/lt/docs/guide/account/saved-data)



## Pamėgti duomenų rinkinį [#pamėgti-duomenų-rinkinį]

Duomenų rinkinio puslapyje, dešinėje esančiame skydelyje, spustelėkite širdelę **Pridėti į pamėgtus**. Širdelė nusidažo raudonai, o rinkinys atsiranda skiltyje **Pamėgta**. Spustelėję ją dar kartą — **Pašalinti iš pamėgtų** — rinkinį pašalinsite.

![Skiltis Pamėgta su vienu duomenų rinkiniu, pažymėta 1–3: 1 stulpeliai Pavadinimas, Kategorija ir Atnaujinta; 2 šiukšliadėžės mygtukas Pašalinti iš pamėgtų; 3 rodyklė Atidaryti](https://guides.dataportal.gov.lt/guide/pamegta.png)

1. **Pavadinimas, Kategorija, Atnaujinta** — sąrašą galima rikiuoti ir filtruoti pagal stulpelius.
2. **Pašalinti iš pamėgtų** — prieš šalinant portalas paklausia patvirtinimo. Pašalinamas tik įrašas jūsų sąraše, pats rinkinys portale lieka.
3. **Atidaryti** — atveria duomenų rinkinio puslapį.

## Išsaugoti lentelę [#išsaugoti-lentelę]

Pamėgtas rinkinys tėra nuoroda. Išsaugota lentelė — daugiau: ją galima laikyti aplanke, automatiškai atnaujinti ir gauti el. laišką, kai duomenys pasikeičia.

<Steps>
  <Step>
    ### Atverkite lentelę ir spustelėkite „Išsaugoti" [#atverkite-lentelę-ir-spustelėkite-išsaugoti]

    Duomenų rinkinio puslapio skirtuke **Lentelė** mygtukas **Išsaugoti** yra šalia **Stulpeliai** ir **Filtrai**.
  </Step>

  <Step>
    ### Užpildykite išsaugojimo formą [#užpildykite-išsaugojimo-formą]

    ![Langas „Išsaugoti duomenų rinkinį", pažymėta 1–4: 1 Pavadinimas; 2 Aplankas; 3 Automatiškai atnaujinti duomenų rinkinį su atnaujinimo būdais Fiksuota laikotarpio pradžia ir Slenkanti laiko eilutė; 4 Noriu gauti pranešimus apie duomenų atnaujinimus su el. pašto adresu](https://guides.dataportal.gov.lt/guide/issaugoti-forma.png)

    1. **Pavadinimas** — iš anksto įrašomas lentelės pavadinimas; galite jį pakeisti.
    2. **Aplankas** — pasirinkite esamą arba **Sukurti naują aplanką** ir įrašykite jo pavadinimą.
    3. **Automatiškai atnaujinti duomenų rinkinį** — pažymėta iš anksto. Pasirinkite atnaujinimo būdą (žr. lentelę žemiau).
    4. **Noriu gauti pranešimus apie duomenų atnaujinimus** — pažymėta iš anksto; pasirinkite **El. pašto adresą**. Nuėmus žymą, laiškų nebus.

    | Atnaujinimo būdas                              | Kas vyksta                                                                        | Pavyzdys: išsaugota 2020–2024 m.                    |
    | ---------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------- |
    | **Fiksuota laikotarpio pradžia** (numatytasis) | Pradžios data nesikeičia — pridedami vis naujesni duomenys nuo pasirinktos datos. | Pasirodžius 2025 m. duomenims matysite 2020–2025 m. |
    | **Slenkanti laiko eilutė**                     | Laikotarpio ilgis nesikeičia — seniausi duomenys pakeičiami naujesniais.          | Pasirodžius 2025 m. duomenims matysite 2021–2025 m. |
  </Step>

  <Step>
    ### Spustelėkite „Išsaugoti" [#spustelėkite-išsaugoti]

    Portalas patvirtina: &#x2A;*„Duomenų rinkinys išsaugotas sėkmingai."** Nuoroda **Peržiūrėti** nuveda į skiltį **Išsaugota**.
  </Step>
</Steps>

## Skiltis „Išsaugota" [#skiltis-išsaugota]

![Skiltis Išsaugota su viena lentele, pažymėta 1–5: 1 skirtukai Visi ir Neperžiūrėti bei paieška; 2 pavadinimas su perbrauktu varpeliu; 3 stulpelis Aplankai; 4 stulpeliai Filtrai ir Atnaujinta; 5 Veiksmai — meniu ir rodyklė Atidaryti](https://guides.dataportal.gov.lt/guide/issaugota.png)

1. **Visi** ir **Neperžiūrėti** — sąrašo skirtukai; paieška — **Ieškoti tarp išsaugotų**.
2. **Pavadinimas** — perbrauktas varpelis šalia rodo, kad pranešimai apie atnaujinimus išjungti.
3. **Aplankai** — pagal šį stulpelį sąrašą galima rikiuoti (A–Z, Z–A) ir filtruoti (pažymėkite aplankus ir spustelėkite **Pritaikyti**).
4. **Filtrai** ir **Atnaujinta** — lentelės filtrai ir paskutinio duomenų atnaujinimo data.
5. **Veiksmai** — meniu **⋯**: **Įjungti prenumeratą** (laiškai apie atnaujinimus) ir **Pašalinti**; rodyklė **Atidaryti** atveria duomenų rinkinį.

Šalinant įrašą portalas paklausia patvirtinimo. Pašalinamas tik įrašas jūsų sąraše — originalūs duomenys portale lieka.

<Tips>
  * **Norite laiškų apie atnaujinimus?** Išsaugodami lentelę palikite pažymėtą **Noriu gauti pranešimus apie duomenų atnaujinimus**. Jau išsaugotai lentelei juos įjungsite skiltyje **Išsaugota*&#x2A;: &#x2A;*⋯** → **Įjungti prenumeratą**.
  * **Aplankai lieka.** Pašalinus paskutinį aplanko įrašą, aplankas vis tiek lieka sąraše — jį galėsite vėl pasirinkti išsaugodami.
</Tips>


# Pranešimai (https://guides.dataportal.gov.lt/lt/docs/guide/account/notifications)



Varpelis viršutiniame dešiniajame kampe atveria skiltį **Pranešimai** — čia kaupiami jums skirti portalo pranešimai.

![Skiltis Pranešimai, pažymėta 1–4: 1 skirtukai Visi, Neperskaityti, Archyvuoti ir paieška; 2 žymimasis langelis pranešimams pažymėti; 3 stulpeliai Kategorija, Laikas ir Veiksmas; 4 krumpliaratis — Pranešimų nustatymai](https://guides.dataportal.gov.lt/guide/paskyra-pranesimai.png)

1. **Visi**, **Neperskaityti** ir **Archyvuoti** — sąrašo skirtukai; šalia — paieška.
2. **Žymimasis langelis** — pažymėkite kelis pranešimus iš karto: **Visi**, **Nieko**, **Perskaityti** arba **Neperskaityti**.
3. **Kategorija**, **Laikas** ir **Veiksmas** — sąrašą galima filtruoti pagal kategoriją ir rikiuoti pagal laiką.
4. **Pranešimų nustatymai** — krumpliaratis viršuje dešinėje.

## Pranešimų nustatymai [#pranešimų-nustatymai]

Čia pasirenkate, apie ką norite gauti **el. laiškus**. Kiekvienam pranešimo tipui — atskiras jungiklis.

![Pranešimų nustatymai, pažymėta 1–4: 1 Duomenų rinkiniai, Naudojimo atvejai ir Išsaugoti; 2 privalomi Paslaugos, Mokėjimai ir Profilis; 3 Teisiniai; 4 mygtukai Atstatyti numatytuosius ir Išsaugoti pakeitimus](https://guides.dataportal.gov.lt/guide/pranesimu-nustatymai.png)

1. **Duomenų rinkiniai**, **Naudojimo atvejai**, **Išsaugoti** — iš pradžių išjungta; galite įjungti.
2. **Paslaugos**, **Mokėjimai**, **Profilis** — visada įjungta: šie pranešimai privalomi ir jų išjungti negalima.
3. **Teisiniai** — iš pradžių išjungta; galite įjungti.
4. **Išsaugoti pakeitimus** — įrašo pasirinkimus; **Atstatyti numatytuosius** — grąžina pradinius nustatymus.


# Paslaugų užsakymai ir mokėjimai (https://guides.dataportal.gov.lt/lt/docs/guide/account/orders)



Skiltyje **Paslaugos** matysite savo [paslaugų](https://guides.dataportal.gov.lt/lt/docs/guide/services) paraiškas:

* **Pateiktos paraiškos** — išsiųstos VDA.
* **Pildomos paraiškos** — juodraščiai, kuriuos išsaugojote nebaigę pildyti.

![Skiltis Paslaugos, pažymėta 1–3: 1 skirtukai Pateiktos paraiškos ir Pildomos paraiškos; 2 paieška; 3 mygtukas Užsakyti paslaugą](https://guides.dataportal.gov.lt/guide/paslaugos-paskyra.png)

1. **Pateiktos paraiškos** ir **Pildomos paraiškos** — sąrašo skirtukai.
2. **Ieškoti tarp paslaugų** — paieška jūsų paraiškose.
3. **Užsakyti paslaugą** — atveria užsakymo formą.

## Užsakymo forma [#užsakymo-forma]

Mygtukas **Užsakyti paslaugą** atveria užsakymo formą:

<Steps>
  <Step>
    ### Paslaugos užsakovas [#paslaugos-užsakovas]

    Pasirinkite, kas užsako:

    ![Užsakymo formos žingsnis „Paslaugos užsakovas", pažymėta 1–4: 1 Fizinis asmuo; 2 Verslas; 3 Mokslas ir studijos; 4 Valstybė](https://guides.dataportal.gov.lt/guide/paslaugos-uzsakovas.png)

    1. **Fizinis asmuo** — Lietuvos Respublikos pilietis, užsienio valstybės pilietis ar asmuo be pilietybės.
    2. **Verslas** — privatūs juridiniai asmenys ar savarankišką darbą dirbantys fiziniai asmenys.
    3. **Mokslas ir studijos** — asmenys, atstovaujantys mokslinius tyrimus vykdančiai institucijai.
    4. **Valstybė** — valstybės kontroliuojamos ir finansuojamos įstaigos ir organizacijos.
  </Step>

  <Step>
    ### Paslauga [#paslauga]

    Pasirinkite paslaugą. Kurios aktyvios, priklauso nuo užsakovo: fiziniam asmeniui — tik **Gauti duomenis**. Pirmojo žingsnio pasirinkimą pakeisite pieštuku šalia jo.
  </Step>

  <Step>
    ### Užsakomi duomenys [#užsakomi-duomenys]

    Nurodykite **Duomenų tipą** (statistinė informacija ir (ar) administraciniai duomenys arba sveikatos duomenys) ir laukelyje &#x2A;*Kokių duomenų reikia?** (iki 2000 simbolių) aprašykite, ko reikia. Spustelėkite **Tęsti** arba **Išsaugoti juodraštį ir uždaryti** — juodraštis atsiras skirtuke **Pildomos paraiškos**.
  </Step>
</Steps>

Kas vyksta pateikus paraišką, aprašyta puslapyje [Paslaugos](https://guides.dataportal.gov.lt/lt/docs/guide/services#kaip-užsakyti&#x29;. Pagalbos užsakant: **+370 689 76 725*&#x2A;, &#x2A;*[info@stat.gov.lt](mailto:info@stat.gov.lt)**.

## Mokėjimai [#mokėjimai]

Skiltyje **Mokėjimai** — jūsų laukiantys ir atlikti mokėjimai už paslaugas: &#x2A;*Užsakymo Nr.**, **Paslaugos pavadinimas**, **Mokėjimo būsena** ir **Užsakymo data**. Sąrašą galima ieškoti ir rikiuoti; kai mokėjimų atsiranda, rodomi ir filtrai.


# Profilis ir prisijungimų istorija (https://guides.dataportal.gov.lt/lt/docs/guide/account/profile)



Skiltyje **Profilio informacija** galite pakeisti savo kontaktinius duomenis ir peržiūrėti, kada ir iš kur jungtasi prie paskyros.

![Profilio informacija (pavyzdiniai asmens duomenys), pažymėta 1–4: 1 mygtukas Prisijungimų istorija; 2 Vardas ir Pavardė; 3 El. paštas ir Tel. numeris; 4 Išsaugoti pakeitimus](https://guides.dataportal.gov.lt/guide/profilis.png)

1. **Prisijungimų istorija** — atveria jūsų prisijungimų žurnalą.
2. **Vardas** ir **Pavardė** — gaunami iš El. valdžios vartų, jų keisti negalima.
3. **El. paštas** ir **Tel. numeris** (su šalies kodu) — galite pakeisti.
4. **Išsaugoti pakeitimus** — tampa aktyvus, kai ką nors pakeičiate.

## Prisijungimų istorija [#prisijungimų-istorija]

**Prisijungimų istorija** atveria **Autentifikacijos žurnalą** — po eilutę kiekvienam prisijungimui:

![Autentifikacijos žurnalas su dviem prisijungimais (pavyzdiniai IP adresai, naršyklė ir laikas): stulpeliai Įvykio tipas, Detalės, IP adresas, Naršyklės identifikatorius, Ar įvykis sėkmingas, Sukurta](https://guides.dataportal.gov.lt/guide/prisijungimu-istorija.png)

| Stulpelis                                        | Ką rodo                             |
| ------------------------------------------------ | ----------------------------------- |
| **Įvykio tipas**                                 | Pavyzdžiui, *Prisijungimas*.        |
| **Detalės**                                      | Papildoma informacija, jei jos yra. |
| **IP adresas** ir **Naršyklės identifikatorius** | Iš kur ir kokia naršykle jungtasi.  |
| **Ar įvykis sėkmingas**                          | *Taip*, jei prisijungimas pavyko.   |
| **Sukurta**                                      | Data ir laikas.                     |


# Prenumerata (https://guides.dataportal.gov.lt/lt/docs/guide/subscription)



Portalas gali el. paštu pranešti apie duomenų atnaujinimus ir kitas naujienas. Prenumerata užsakoma portalo apačioje, skiltyje **Sekite mūsų naujienas**.

![Prenumeratos forma portalo apačioje, pažymėta 1–3: 1 el. pašto laukas; 2 temos pasirinkimas; 3 prenumeravimo mygtukas](https://guides.dataportal.gov.lt/guide/prenumerata.png)

1. **El. pašto laukas.**
2. **Temos pasirinkimas.**
3. **Prenumeravimo mygtukas.**

Prieš spustelėdami, pažymėkite sutikimo laukelį po laukais.

## Kaip užsisakyti [#kaip-užsisakyti]

<Steps>
  <Step>
    ### Įrašykite el. paštą [#įrašykite-el-paštą]

    Portalo apačioje, laukelyje **El. paštas**, įveskite adresą, kuriuo norėsite gauti naujienas.
  </Step>

  <Step>
    ### Pasirinkite temą [#pasirinkite-temą]

    Iš sąrašo **Tema** pasirinkite dominančią sritį (pavyzdžiui, *Ekonomika ir finansai* ar *Sveikata*) — gausite tik jos naujienas.
  </Step>

  <Step>
    ### Patvirtinkite ir prenumeruokite [#patvirtinkite-ir-prenumeruokite]

    Pažymėkite sutikimo laukelį (taip sutinkate su Privatumo ir Slapukų politika) ir spustelėkite **Prenumeruoti**.
  </Step>
</Steps>

Nuo šiol nurodytu adresu gausite pranešimus apie pasirinktos temos duomenų atnaujinimus ir naujienas.

<Tips>
  * **Viena tema — viena prenumerata.** Norite sekti kelias sritis? Prenumeruokite kelis kartus, kiekvienai temai atskirai.
</Tips>


# Portalo nustatymai (https://guides.dataportal.gov.lt/lt/docs/guide/portal-settings)



Portalą galima prisitaikyti sau: perjungti kalbą ir įjungti geresnio skaitomumo nustatymus. Abu valdikliai yra portalo viršuje, dešiniajame kampe.

## Kalba [#kalba]

Portalas veikia lietuvių ir anglų kalbomis. Kalbą perjungsite **kalbos mygtuku** portalo viršuje — jame rodoma kita kalba (pavyzdžiui, *EN*, kai naršote lietuviškai). Tas pats perjungiklis yra ir portalo apačioje.

## Pritaikomumas [#pritaikomumas]

Prie kalbos mygtuko yra **Pritaikomumo nustatymai** — spustelėjus atsidaro langas su geresnio skaitomumo parinktimis:

![Langas Pritaikomumas, pažymėta 1–4: 1 jungiklis Lengvai skaitomas šriftas (Verdana, Arial, Helvetica, sans-serif šriftai); 2 jungiklis Monochromatinės spalvos; 3 jungiklis Didelis kontrastas; 4 mygtukas Atstatyti pritaikomumo nustatymus](https://guides.dataportal.gov.lt/guide/portalo-nustatymai-v2.png)

1. **Lengvai skaitomas šriftas.**
2. **Monochromatinės spalvos.**
3. **Didelis kontrastas.**
4. **Atstatyti pritaikomumo nustatymus.**

| Parinktis                     | Ką daro                                                                                    |
| ----------------------------- | ------------------------------------------------------------------------------------------ |
| **Lengvai skaitomas šriftas** | Visoje svetainėje naudoja lengviau skaitomą sans-serif šriftą (Verdana, Arial, Helvetica). |
| **Monochromatinės spalvos**   | Sumažina spalvų intensyvumą geresniam skaitomumui.                                         |
| **Didelis kontrastas**        | Padidina vaizdinį kontrastą geresniam skaitomumui.                                         |

Parinktys įsijungia iškart ir išlieka naršant. Norėdami grįžti į įprastą vaizdą, tame pačiame lange spustelėkite **Atstatyti pritaikomumo nustatymus**.


# Duomenų API (https://guides.dataportal.gov.lt/lt/docs/api)



Vieša, tik skaitymui skirta HTTP sąsaja Lietuvos atvirų duomenų portalo duomenų ežerui – Apache Iceberg lentelėms ir saugomiems failams. Autentifikacija nereikalinga.

Naršykite vardų erdves ir skaitykite lentelių schemas su `GET`; užklauskite ir eksportuokite lentelės eilutes su `POST` (kūne perduodamas tik užklausos aprašas – API lieka tik skaitymui). Skaitykite eilutes JSON formatu arba eksportuokite visas lenteles kaip NDJSON, JSON, CSV, Excel ar Parquet. Sąvokas, tikrą užklausų gramatiką ir pavyzdžius rasite vadovuose.

<Callout title="Bazinis URL ir prieiga">
  Visi pavyzdžiai kreipiasi į &#x2A;*[https://api.dataportal.gov.lt](https://api.dataportal.gov.lt)**. API yra vieša ir nereikalauja jokio rakto ar prieigos rakto. Naršyklės programoms: API nesiunčia CORS antraščių, todėl kreipkitės iš savo serverio (arba, šioje dokumentacijoje, per įmontuotą tarpinį serverį).
</Callout>

## Sritys pagal paskirtį [#sritys-pagal-paskirtį]

<Cards>
  <Card title="Nuo ko pradėti" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/overview" description="Kaip API veikia: sąvokos, užklausos, atsisiuntimai" />

  <Card title="Vardų erdvės" href="https://guides.dataportal.gov.lt/lt/docs/api/namespaces/listNamespaces" description="Vardų erdvės – galiniai taškai" />

  <Card title="Lentelės" href="https://guides.dataportal.gov.lt/lt/docs/api/tables/getTableSchema" description="Lentelės – galiniai taškai" />

  <Card title="Failai" href="https://guides.dataportal.gov.lt/lt/docs/api/files/downloadFile" description="Failai – galiniai taškai" />
</Cards>

## OpenAPI specifikacija [#openapi-specifikacija]

Atsisiųskite pilną specifikaciją (`servers` įterpiami vykdymo metu) iš [`/api/openapi`](https://guides.dataportal.gov.lt/api/openapi). Jei API neturi CORS, užklausas iš dokumentacijos gali peradresuoti `/api/proxy`.


# Apžvalga (https://guides.dataportal.gov.lt/lt/docs/api/guides/overview)



**Duomenų API** – tai vieša HTTP sąsaja atvirų duomenų, skelbiamų Lietuvos
duomenų portale, skaitymui. Ji atveria portalo duomenų ežerą –
[Apache Iceberg](https://iceberg.apache.org/) lenteles ir saugomus failus: vardų
erdves ir schemas skaitykite su `GET`, o lentelės eilutes **užklauskite** ar
**eksportuokite** su `POST`, grąžinančiu JSON, NDJSON, CSV, Excel arba Parquet.

<Callout title="Tik skaitymui ir vieša">
  **Autentifikacija nereikalinga** – nėra jokių API raktų, prieigos raktų ar OAuth
  apimčių. Katalogo ir failų skaitymas yra `GET`; lentelės **užklausos** ir
  **eksportas** yra `POST` su JSON kūnu (API vis tiek tik skaitymui – `POST&#x60; perduoda
  tik užklausos aprašą). Visuose pavyzdžiuose naudojamas bazinis URL
  &#x2A;*`https://api.dataportal.gov.lt`** ir tikri, gyvi duomenys.
</Callout>

Visuose vadovuose naudojame vieną tikrą duomenų rinkinį –
[**Toksikologinių tyrimų rezultatai mirties atvejais**](https://dataportal.gov.lt/lt/datasets/od000503)
(Higienos institutas) – kad kiekvieną pavyzdį būtų galima nukopijuoti ir paleisti:

<ParamTable
  lang="lt"
  params="[
  { name: &#x22;Vardų erdvė&#x22;, type: &#x22;111958286&#x22;, description: &#x22;Duomenis skelbianti organizacija (Higienos instituto įmonės kodas).&#x22; },
  { name: &#x22;Lentelė&#x22;, type: &#x22;mirusiuju_toksikologinis_rezultatas&#x22;, description: &#x22;22 143 eilutės, 14 stulpelių.&#x22; },
]"
/>

## Išbandykite gyvai [#išbandykite-gyvai]

Pasirinkite stulpelius, nustatykite filtrą, rūšiavimą ir puslapį, tada spauskite
**Vykdyti**, kad iškviestumėte tikrą API tiesiai iš naršyklės. Užklausą
peradresuoja dokumentacijos svetainė, todėl ji veikia net ir tada, kai API
nesiunčia CORS antraščių.

<ApiExplorer
  lang="lt"
  namespace="111958286"
  table="mirusiuju_toksikologinis_rezultatas"
  defaultSelected="[&#x22;lytis&#x22;, &#x22;amziaus_grupe&#x22;, &#x22;mirties_metai&#x22;, &#x22;pavadinimas&#x22;, &#x22;mirties_priezastis&#x22;]"
  defaultLimit="5"
  defaultSort="mirties_metai"
  columns="[
  { name: &#x22;_id&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;vda_id&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;mirties_id&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;t_rez&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;m_konc&#x22;, type: &#x22;double&#x22; },
  { name: &#x22;mk_vienetai&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;pavadinimas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;gr_pavadinimas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;tipo_pavadinimas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;lytis&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;mirties_metai&#x22;, type: &#x22;long&#x22; },
  { name: &#x22;gyv_tipas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;amziaus_grupe&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;mirties_priezastis&#x22;, type: &#x22;string&#x22; },
]"
  sample="{
  data: [
    { lytis: &#x22;Moteris&#x22;, amziaus_grupe: &#x22;65_69&#x22;, mirties_metai: 2021, pavadinimas: &#x22;Etanolis (etilo alkoholis)&#x22;, mirties_priezastis: &#x22;Kita&#x22; },
    { lytis: &#x22;Moteris&#x22;, amziaus_grupe: &#x22;65_69&#x22;, mirties_metai: 2018, pavadinimas: &#x22;Karboksihemoglobinas&#x22;, mirties_priezastis: &#x22;Atsitiktiniai apsinuodijimai&#x22; },
  ],
  total: 22143,
  total_pages: 4429,
  current_page: 1,
}"
/>

## Kaip sudėlioti duomenys [#kaip-sudėlioti-duomenys]

API turi tris išteklių rūšis:

* **Vardų erdvė** – talpykla, identifikuojama tašku atskirtu keliu. Čia vardų
  erdvė yra duomenų teikėjo įmonės kodas, `111958286`. Vardų erdvė talpina
  antrines vardų erdves, lenteles ir failus, todėl katalogas sudaro medį, kurį
  galima naršyti nuo šaknies žemyn.
* **Lentelė** – Iceberg lentelė, kurios schemą galima peržiūrėti, eilutes –
  **užklausti** po vieną JSON formatu arba **eksportuoti** dideliais kiekiais
  NDJSON, JSON, CSV, Excel ar Parquet formatu.
* **Failas** – saugomas objektas (PDF, paveikslėlis, archyvas ir kt.), pateikiamas
  tiesiai iš objektų saugyklos.

<CatalogueTree
  namespace="111958286"
  org="Higienos institutas"
  tables="[
  { name: &#x22;mirusiuju_toksikologinis_rezultatas&#x22;, ops: [&#x22;schema&#x22;, &#x22;užklausa&#x22;, &#x22;eksportas&#x22;] },
  { name: &#x22;gimimas&#x22;, ops: [&#x22;schema&#x22;, &#x22;užklausa&#x22;, &#x22;eksportas&#x22;] },
]"
  more="daugiau lentelių"
  files="[{ name: &#x22;report.pdf&#x22;, ops: [&#x22;atsisiuntimas&#x22;] }]"
/>

## Ką galima daryti [#ką-galima-daryti]

<ParamTable
  lang="lt"
  params="[
  { name: &#x22;Gauti šaknies vardų erdves&#x22;, type: &#x22;GET /namespaces&#x22;, description: <a href=&#x22;/lt/docs/api/namespaces/listNamespaces&#x22;>listNamespaces →</a> },
  { name: &#x22;Naršyti vieną vardų erdvę&#x22;, type: &#x22;GET /namespaces/{namespace}&#x22;, description: <a href=&#x22;/lt/docs/api/namespaces/getNamespace&#x22;>getNamespace →</a> },
  { name: &#x22;Peržiūrėti lentelės schemą&#x22;, type: &#x22;.../tables/{table}/schema&#x22;, description: <a href=&#x22;/lt/docs/api/tables/getTableSchema&#x22;>getTableSchema →</a> },
  { name: &#x22;Skaityti eilutes JSON formatu&#x22;, type: &#x22;POST .../tables/{table}/query&#x22;, description: <a href=&#x22;/lt/docs/api/tables/queryTable&#x22;>queryTable →</a> },
  { name: &#x22;Eksportuoti lentelę&#x22;, type: &#x22;POST .../tables/{table}/export&#x22;, description: <a href=&#x22;/lt/docs/api/tables/exportTable&#x22;>exportTable →</a> },
  { name: &#x22;Atsisiųsti failą&#x22;, type: &#x22;.../files/{fileName}&#x22;, description: <a href=&#x22;/lt/docs/api/files/downloadFile&#x22;>downloadFile →</a> },
]"
/>

## Greitas startas [#greitas-startas]

<Steps>
  <Step>
    ### Gaukite šaknies vardų erdves [#gaukite-šaknies-vardų-erdves]

    <MethodPath method="GET" path="/namespaces" />

    ```bash
    curl 'https://api.dataportal.gov.lt/namespaces'
    ```

    ```json
    { "success": true, "data": { "namespaces": ["111958286", "188774975", "…"] } }
    ```
  </Step>

  <Step>
    ### Įeikite į vardų erdvę [#įeikite-į-vardų-erdvę]

    Pamatysite jos antrines vardų erdves, lenteles ir failus.

    ```bash
    curl 'https://api.dataportal.gov.lt/namespaces/111958286'
    ```

    ```json
    {
      "success": true,
      "data": {
        "current_namespace": "111958286",
        "child_namespaces": [],
        "tables": ["mirusiuju_toksikologinis_rezultatas", "gimimas", "…"],
        "files": []
      }
    }
    ```
  </Step>

  <Step>
    ### Peržiūrėkite lentelės schemą [#peržiūrėkite-lentelės-schemą]

    Sužinokite stulpelių pavadinimus ir tipus prieš užklausą.

    ```bash
    curl 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/schema'
    ```
  </Step>

  <Step>
    ### Užklauskite eilutes [#užklauskite-eilutes]

    Siųskite JSON kūną, prašydami pirmų 5 eilučių, naujausios viršuje, paliekant kelis stulpelius:

    ```bash
    curl -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
      -H 'Content-Type: application/json' \
      -d '{"limit":5,"sort":"-mirties_metai","select":"lytis,mirties_metai,pavadinimas"}'
    ```

    ```json
    { "data": [ /* … 5 eilutės … */ ], "total": 22143, "total_pages": 4429, "current_page": 1 }
    ```
  </Step>

  <Step>
    ### Eksportuokite dideliais kiekiais [#eksportuokite-dideliais-kiekiais]

    Kai norite viso rezultatų rinkinio kaip failo, o ne puslapiuoto JSON – eksporto
    galinis taškas priima tokį patį kūną ir `format` užklausos parametrą:

    ```bash
    curl -L -o toksikologija.ndjson \
      -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/export?format=ndjson' \
      -H 'Content-Type: application/json' \
      -d '{}'
    ```
  </Step>
</Steps>

## Atsakymo formatas [#atsakymo-formatas]

Katalogo ir schemos galiniai taškai savo turinį įvynioja į &#x2A;*`{ success, data }`**
struktūrą. **Užklausos** galinis taškas skiriasi – jis grąžina eilutes ir
poslinkiu grįstus puslapiavimo metaduomenis, be `success` apvalkalo:

<Tabs items="[&#x22;Katalogas / schema&#x22;, &#x22;Užklausa&#x22;, &#x22;Eksportas / failas&#x22;]">
  <Tab value="Katalogas / schema">
    ```json
    { "success": true, "data": { "…": "…" } }
    ```
  </Tab>

  <Tab value="Užklausa">
    ```json
    { "data": [ /* eilutės */ ], "total": 22143, "total_pages": 4429, "current_page": 1 }
    ```
  </Tab>

  <Tab value="Eksportas / failas">
    Neapdorotas baitų srautas – NDJSON / JSON / CSV / Parquet arba paties failo turinio tipas – o ne JSON.
  </Tab>
</Tabs>

Klaidose pateikiamas `error_code` ir žinutė. Tikslias struktūras ir būsenos kodus
(`400`, `404`, `502`, `503`, `504`) rasite skiltyje [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors).

## Kur toliau [#kur-toliau]

<Cards>
  <Card title="Sąvokos" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts" description="Vardų erdvės, lentelės, failai, Iceberg schemos ir momentinės kopijos." />

  <Card title="Užklausos į lenteles" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/querying" description="select, filter, sort ir poslinkio puslapiavimas – su tikra gramatika." />

  <Card title="Duomenų atsisiuntimas" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading" description="NDJSON / JSON / CSV / Excel / Parquet išvestis per eksporto galinį tašką." />

  <Card title="Pavyzdžiai" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/recipes" description="Kopijuojami sprendimai: skaičiuoti, filtruoti, puslapiuoti, eksportuoti." />

  <Card title="Klaidos" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/errors" description="Būsenos kodai ir API grąžinamų klaidų struktūros." />
</Cards>

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)
* [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
* [Duomenų ir failų atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)
* [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors)
* [Pavyzdžiai](https://guides.dataportal.gov.lt/lt/docs/api/guides/recipes)


# Sąvokos (https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)



Duomenų API veikia virš [Apache Iceberg](https://iceberg.apache.org/) duomenų
ežero, užklausiamo per Trino. Kiekviena užklausa yra tik skaitymui – vardų erdves
naršote ir schemas skaitote su `GET`, o eilutes užklausiate ar eksportuojate su
`POST` (kūne perduodamas tik užklausos aprašas). Verta suprasti penkis statybinius
blokus:

## Vardų erdvė [#vardų-erdvė]

**Vardų erdvė** – tai talpykla, identifikuojama tašku atskirtu keliu. Šiame
portale vardų erdvė paprastai yra duomenis skelbiančios organizacijos įmonės
kodas – mūsų pavyzdinis rinkinys yra vardų erdvėje `111958286` (Higienos
institutas).

Vardų erdvė pateikia savo **antrines vardų erdves**, **lenteles** ir **failus**,
todėl visas katalogas yra medis, kurį naršote nuo šaknies:

<MethodPath method="GET" path="/namespaces/111958286" />

```json
{
  "success": true,
  "data": {
    "current_namespace": "111958286",
    "child_namespaces": [],
    "tables": ["mirusiuju_toksikologinis_rezultatas", "gimimas", "…"],
    "files": []
  }
}
```

Iškvieskite [`GET /namespaces`](https://guides.dataportal.gov.lt/lt/docs/api/namespaces/listNamespaces) be kelio,
kad gautumėte šaknies sąrašą.

## Lentelė [#lentelė]

**Lentelė** – tai Iceberg lentelė, su kuria galima daryti tris dalykus:

<Cards>
  <Card title="Schema" href="https://guides.dataportal.gov.lt/lt/docs/api/tables/getTableSchema" description="Perskaitykite stulpelius, tipus ir null leistinumą." />

  <Card title="Užklausa" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/querying" description="Skaitykite eilutes JSON formatu su filtru / rūšiavimu / puslapiavimu." />

  <Card title="Eksportas" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading" description="Atsisiųskite visą lentelę kaip NDJSON / JSON / CSV / Parquet." />
</Cards>

## Schema [#schema]

Prieš užklausą perskaitykite lentelės schemą, kad žinotumėte tikslius stulpelių
pavadinimus ir tipus. Schema yra Iceberg loginė schema: kiekvienas laukas turi
pastovų skaitinį **id** (Iceberg seka stulpelius pagal id net juos pervadinus),
**tipą** ir **privalomumo** (ne-null) žymę.

<MethodPath method="GET" path="/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/schema" />

Štai tikra mūsų pavyzdinės lentelės schema:

<SchemaTable
  lang="lt"
  caption="mirusiuju_toksikologinis_rezultatas — 14 laukų"
  fields="[
  { id: 1, name: &#x22;_id&#x22;, type: &#x22;string&#x22;, required: true, description: &#x22;Unikalus įrašo identifikatorius.&#x22; },
  { id: 2, name: &#x22;vda_id&#x22;, type: &#x22;string&#x22;, description: &#x22;Valstybės duomenų agentūros įrašo id.&#x22; },
  { id: 3, name: &#x22;mirties_id&#x22;, type: &#x22;string&#x22;, description: &#x22;Mirties atvejo identifikatorius.&#x22; },
  { id: 4, name: &#x22;t_rez&#x22;, type: &#x22;string&#x22;, description: &#x22;Toksikologinio tyrimo rezultato kodas.&#x22; },
  { id: 5, name: &#x22;m_konc&#x22;, type: &#x22;double&#x22;, description: &#x22;Nustatyta medžiagos koncentracija.&#x22; },
  { id: 6, name: &#x22;mk_vienetai&#x22;, type: &#x22;string&#x22;, description: &#x22;Koncentracijos matavimo vieneto kodas.&#x22; },
  { id: 7, name: &#x22;pavadinimas&#x22;, type: &#x22;string&#x22;, description: &#x22;Medžiagos pavadinimas.&#x22; },
  { id: 8, name: &#x22;gr_pavadinimas&#x22;, type: &#x22;string&#x22;, description: &#x22;Medžiagos grupės pavadinimas.&#x22; },
  { id: 9, name: &#x22;tipo_pavadinimas&#x22;, type: &#x22;string&#x22;, description: &#x22;Medžiagos tipo pavadinimas.&#x22; },
  { id: 10, name: &#x22;lytis&#x22;, type: &#x22;string&#x22;, description: &#x22;Mirusiojo lytis.&#x22; },
  { id: 11, name: &#x22;mirties_metai&#x22;, type: &#x22;long&#x22;, description: &#x22;Mirties metai.&#x22; },
  { id: 12, name: &#x22;gyv_tipas&#x22;, type: &#x22;string&#x22;, description: &#x22;Gyvenamosios vietos tipas (miestas / kaimas).&#x22; },
  { id: 13, name: &#x22;amziaus_grupe&#x22;, type: &#x22;string&#x22;, description: &#x22;Amžiaus grupė.&#x22; },
  { id: 14, name: &#x22;mirties_priezastis&#x22;, type: &#x22;string&#x22;, description: &#x22;Mirties priežasties grupė (TLK-10-AM).&#x22; },
]"
/>

Dažni Iceberg tipai, kuriuos pamatysite: `string`, `long`, `int`, `double`,
`boolean`, `date`, `timestamp` ir sudėtinis `struct`.

## Failas [#failas]

**Failas** – tai saugomas objektas, pateikiamas tiesiai iš objektų saugyklos:
PDF, paveikslėlis ar archyvas, susietas su vardų erdve. Failo pavadinimas yra
vienas bazinis vardas (be `/`), o atsakymas yra neapdoroti baitai su pirminiu
`Content-Type`.

<MethodPath method="GET" path="/namespaces/{namespace}/files/{fileName}" />

## Momentinė kopija [#momentinė-kopija]

Iceberg saugo lentelės **momentinių kopijų** istoriją. Kiekvienas įrašymas sukuria
naują kopiją su skaitiniu `snapshot_id`. API skaito **naujausią** momentinę kopiją –
užklausos ir eksportas visada atspindi dabartinę lentelės būseną.

## Atsakymo struktūra [#atsakymo-struktūra]

API egzistuoja dvi atsakymo formos – įsidėmėkite skirtumą:

<Tabs items="[&#x22;{ success, data }&#x22;, &#x22;Užklausos rezultatas&#x22;, &#x22;Baitų srautas&#x22;]">
  <Tab value="{ success, data }">
    Vardų erdvės ir schemos galiniai taškai įvynioja turinį:

    ```json
    { "success": true, "data": { "…": "…" } }
    ```
  </Tab>

  <Tab value="Užklausos rezultatas">
    Užklausos galinis taškas grąžina eilutes ir poslinkio puslapiavimo metaduomenis – **be** `success` lauko:

    ```json
    { "data": [ /* eilutės */ ], "total": 22143, "total_pages": 4429, "current_page": 1 }
    ```
  </Tab>

  <Tab value="Baitų srautas">
    Eksporto ir failo galiniai taškai grąžina neapdorotus baitus (NDJSON / JSON / CSV / Excel / Parquet arba failo turinio tipą), o ne JSON.
  </Tab>
</Tabs>

<Cards>
  <Card title="Užklausos į lenteles" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/querying" description="Panaudokite schemą: select, filter, sort, puslapiavimas." />

  <Card title="Duomenų atsisiuntimas" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading" description="Masinis eksportas kaip NDJSON / JSON / CSV / Parquet." />
</Cards>

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
* [Duomenų ir failų atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)
* [Vardų erdvių sąrašas arba šaknies erdvės](https://guides.dataportal.gov.lt/lt/docs/api/namespaces/listNamespaces)


# Užklausos į lenteles (https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)



Skaitykite lentelės eilutes JSON formatu su **užklausos** galiniu tašku. Užklausa
siunčiama JSON užklausos kūne:

<MethodPath method="POST" path="/namespaces/{namespace}/tables/{tableName}/query" />

Jis grąžina eilutes ir poslinkio puslapiavimo metaduomenis:

```json
{ "data": [ /* eilutės */ ], "total": 22143, "total_pages": 4429, "current_page": 1 }
```

## Užklausos kūnas [#užklausos-kūnas]

Siųskite JSON objektą. Kiekvienas laukas nebūtinas – tuščias kūnas `{}` grąžina
pirmą visų stulpelių puslapį.

<ParamTable
  lang="lt"
  params="[
  { name: &#x22;select&#x22;, type: &#x22;string&#x22;, description: &#x22;Kableliais atskirti stulpelių pavadinimai. Praleiskite, kad gautumėte visus.&#x22; },
  { name: &#x22;filter&#x22;, type: &#x22;string&#x22;, description: &#x22;Filtro išraiška: column=value sąlygos su operatoriais ir _and/_or (žr. žemiau).&#x22; },
  { name: &#x22;sort&#x22;, type: &#x22;string&#x22;, description: &#x22;Kableliais atskirti raktai. Prefiksas - – mažėjančiai, + arba be jo – didėjančiai.&#x22; },
  { name: &#x22;limit&#x22;, type: &#x22;int&#x22;, description: &#x22;Didžiausias grąžinamų eilučių skaičius (puslapio dydis).&#x22; },
  { name: &#x22;offset&#x22;, type: &#x22;int&#x22;, default: &#x22;0&#x22;, description: &#x22;Praleidžiamų eilučių skaičius — offset = (puslapis − 1) × limit.&#x22; },
  { name: &#x22;exclude_nulls&#x22;, type: &#x22;string[]&#x22;, description: &#x22;Stulpelis(-iai), kurie turi būti ne-null; eilutės su null ten pašalinamos.&#x22; },
]"
/>

## Stulpelių atranka [#stulpelių-atranka]

`select` – kableliais atskirta projekcija. Praleiskite, kad gautumėte kiekvieną stulpelį.

```bash
curl -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
  -H 'Content-Type: application/json' \
  -d '{"select":"lytis,mirties_metai,pavadinimas","limit":3}'
```

## Filtras [#filtras]

`filter` – tai URL stiliaus išraiška, perduodama kūne kaip eilutė: `column=value`
sąlygos, jungiamos `&`, nebūtinai naudojant palyginimo operatorius ir `_and` /
`_or` grupes. Reikšmės rašomos **be kabučių** – net ir tekstui su tarpais.

```bash
# Lygybė – mirusios moterys (5 243 eilutės)
curl -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
  -H 'Content-Type: application/json' \
  -d '{"filter":"lytis=Moteris","limit":1}'
```

### Operatoriai [#operatoriai]

Prie stulpelio pridėkite **tašku atskirtą, dviraidį** operatorių. Praleiskite jį – gausite lygybę.

<ParamTable
  lang="lt"
  params="[
  { name: &#x22;col=v&#x22;, type: &#x22;lygu&#x22;, description: &#x22;Tiksli atitiktis (pvz., lytis=Moteris).&#x22; },
  { name: &#x22;col._gt=v&#x22;, type: &#x22;daugiau nei&#x22;, description: &#x22;pvz., mirties_metai._gt=2020&#x22; },
  { name: &#x22;col._ge=v&#x22;, type: &#x22;≥&#x22;, description: &#x22;daugiau arba lygu&#x22; },
  { name: &#x22;col._lt=v&#x22;, type: &#x22;mažiau nei&#x22;, description: &#x22;&#x22; },
  { name: &#x22;col._le=v&#x22;, type: &#x22;≤&#x22;, description: &#x22;mažiau arba lygu&#x22; },
  { name: &#x22;col._co=v&#x22;, type: &#x22;yra tarp&#x22;, description: &#x22;poeilutės atitiktis (pvz., pavadinimas._co=Etan)&#x22; },
  { name: &#x22;col._sw=v&#x22;, type: &#x22;prasideda&#x22;, description: &#x22;&#x22; },
  { name: &#x22;col._ew=v&#x22;, type: &#x22;baigiasi&#x22;, description: &#x22;&#x22; },
]"
/>

```bash
# Medžiagos pavadinimas, kuriame yra „Etan" (15 516 eilučių)
curl -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
  -H 'Content-Type: application/json' \
  -d '{"filter":"pavadinimas._co=Etan","limit":1}'
```

<Callout type="warn" title="Naudokite dviraidžius operatorius">
  Operatorių pavadinimai yra **dviraidžiai**: `._ge` / `._le`, o **ne** `._gte` / `._lte`.
  Triraidės formos yra atmetamos užklausų variklio (grįžta kaip `502`). (Kai kurie
  specifikacijos pavyzdžiai rodo `._gte` – tai specifikacijos klaida.)
</Callout>

### Sąlygų jungimas – `_and` / `_or` [#sąlygų-jungimas--_and--_or]

Junkite sąlygas `filter` eilutėje su `&`. Kiekviena papildoma sąlyga pagal
nutylėjimą yra `_and`; prieš ją rašykite `_or.`, kad gautumėte disjunkciją.
Operatorius (arba jokio – lygybei) vis tiek tašku jungiamas prie stulpelio.

```bash
# Nuo 2018 m. IR moteris (4 570 eilučių)
curl -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
  -H 'Content-Type: application/json' \
  -d '{"filter":"mirties_metai._ge=2018&_and.lytis=Moteris","limit":1}'

# moteris ARBA vyras
curl -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
  -H 'Content-Type: application/json' \
  -d '{"filter":"lytis=Moteris&_or.lytis=Vyras","limit":1}'
```

Atsakymo `total` atspindi filtruotą rinkinį, todėl tai greičiausias būdas
patikrinti, ar filtras veikia taip, kaip tikitės.

## Rūšiavimas [#rūšiavimas]

`sort` priima kableliais atskirtus stulpelių pavadinimus. Prefiksas `-` –
mažėjančiai, `+` (arba nieko) – didėjančiai.

```bash
# Naujausios mirtys viršuje
curl -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
  -H 'Content-Type: application/json' \
  -d '{"sort":"-mirties_metai","limit":5}'
```

## Puslapiavimas [#puslapiavimas]

Puslapiavimas yra **poslinkiu grįstas** ir tiesiogiai atitinka SQL `LIMIT` /
`OFFSET`:

* `limit` – puslapio dydis
* `offset` – praleidžiamos eilutės; `offset = (puslapis − 1) × limit`

Atsakymas praneša `total` (visos atitinkančios eilutės), `total_pages` (esamam
`limit`) ir `current_page`.

<Steps>
  <Step>
    ### Pirmas puslapis [#pirmas-puslapis]

    ```bash
    curl -X POST '…/query' -H 'Content-Type: application/json' -d '{"limit":100,"offset":0}'
    ```
  </Step>

  <Step>
    ### Kitas puslapis [#kitas-puslapis]

    Kaskart pridėkite `limit` prie poslinkio – 2 puslapis yra `offset=100`, 3 – `offset=200`, …

    ```bash
    curl -X POST '…/query' -H 'Content-Type: application/json' -d '{"limit":100,"offset":100}'
    ```
  </Step>

  <Step>
    ### Pabaiga [#pabaiga]

    Kai `current_page` pasiekia `total_pages` (arba grįžta mažiau nei `limit` eilučių), baigėte.
  </Step>
</Steps>

### Pereiti visus puslapius [#pereiti-visus-puslapius]

Kopijuojama kilpa, kuri puslapiuoja visą lentelę iki paskutinio (trumpo) puslapio:

<CodeTabs labels="[&#x22;cURL&#x22;, &#x22;Python&#x22;, &#x22;JavaScript&#x22;]">
  ```bash
  URL='https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query'
  LIMIT=1000
  OFFSET=0
  while :; do
    RESP=$(curl -s -X POST "$URL" -H 'Content-Type: application/json' \
      -d "{\"limit\":$LIMIT,\"offset\":$OFFSET,\"sort\":\"_id\"}")
    COUNT=$(echo "$RESP" | jq '.data | length')
    echo "offset=$OFFSET  gauta=$COUNT  total=$(echo "$RESP" | jq '.total')"
    [ "$COUNT" -lt "$LIMIT" ] && break   # paskutinis puslapis: maziau nei limit eiluciu
    OFFSET=$((OFFSET + LIMIT))
  done
  ```

  ```python
  import requests

  URL = "https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query"
  limit, offset = 1000, 0
  while True:
      resp = requests.post(URL, json={"limit": limit, "offset": offset, "sort": "_id"}).json()
      rows = resp["data"]
      print(f"offset={offset} gauta={len(rows)} total={resp['total']}")
      if len(rows) < limit:
          break  # paskutinis puslapis
      offset += limit
  ```

  ```js
  const URL = "https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query";
  const limit = 1000;
  let offset = 0;
  while (true) {
    const resp = await (await fetch(URL, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ limit, offset, sort: "_id" }),
    })).json();
    console.log(`offset=${offset} gauta=${resp.data.length} total=${resp.total}`);
    if (resp.data.length < limit) break; // paskutinis puslapis
    offset += limit;
  }
  ```
</CodeTabs>

<Callout type="warn" title="Du dalykai, kurie kliūva">
  * **Visada pridėkite pastovų `sort`** (pvz., `sort=_id`). Be fiksuotos tvarkos
    užklausų variklis skirtingose užklausose gali grąžinti eilutes kitaip, todėl
    poslinkio puslapiavimas gali praleisti arba pakartoti eilutes. `filter` sumažina
    `total`, todėl puslapiuojate filtruotą rinkinį.
  * **Dideli poslinkiai lėtėja** – `OFFSET` vis tiek peržiūri praleidžiamas eilutes.
    Norėdami paimti visą lentelę, iš viso nepuslapiuokite: naudokite
    [eksporto galinį tašką](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading), kuris pateikia visą
    rezultatų rinkinį viena užklausa.
</Callout>

## Null eilučių pašalinimas [#null-eilučių-pašalinimas]

`exclude_nulls` nurodo vieną ar daugiau stulpelių, kurie turi būti ne-null;
eilutės su null bet kuriame iš jų pašalinamos. Perduokite kaip JSON masyvą:

```bash
curl -X POST '…/query' -H 'Content-Type: application/json' \
  -d '{"exclude_nulls":["m_konc","pavadinimas"],"limit":5}'
```

## Išbandykite [#išbandykite]

Sudarykite užklausą gyvai lentelei ir paleiskite ją:

<ApiExplorer
  lang="lt"
  namespace="111958286"
  table="mirusiuju_toksikologinis_rezultatas"
  defaultSelected="[&#x22;lytis&#x22;, &#x22;mirties_metai&#x22;, &#x22;pavadinimas&#x22;, &#x22;gyv_tipas&#x22;]"
  defaultLimit="10"
  defaultSort="mirties_metai"
  defaultFilterColumn="lytis"
  defaultFilterValue="Moteris"
  columns="[
  { name: &#x22;_id&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;vda_id&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;mirties_id&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;t_rez&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;m_konc&#x22;, type: &#x22;double&#x22; },
  { name: &#x22;mk_vienetai&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;pavadinimas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;gr_pavadinimas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;tipo_pavadinimas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;lytis&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;mirties_metai&#x22;, type: &#x22;long&#x22; },
  { name: &#x22;gyv_tipas&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;amziaus_grupe&#x22;, type: &#x22;string&#x22; },
  { name: &#x22;mirties_priezastis&#x22;, type: &#x22;string&#x22; },
]"
  sample="{
  data: [
    { lytis: &#x22;Moteris&#x22;, mirties_metai: 2021, pavadinimas: &#x22;Etanolis (etilo alkoholis)&#x22;, gyv_tipas: &#x22;Kaimas&#x22; },
  ],
  total: 5243,
  total_pages: 525,
  current_page: 1,
}"
/>

<Cards>
  <Card title="Duomenų atsisiuntimas" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading" description="Kai norite viso rezultatų rinkinio kaip failo." />

  <Card title="Klaidos" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/errors" description="Kaip atrodo 400 / 404 / 502 atsakymai." />
</Cards>

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)
* [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors)
* [Pavyzdžiai](https://guides.dataportal.gov.lt/lt/docs/api/guides/recipes)
* [Užklausa į lentelės eilutes](https://guides.dataportal.gov.lt/lt/docs/api/tables/queryTable)


# Duomenų ir failų atsisiuntimas (https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)



**Užklausos** galinis taškas skirtas eilutėms skaityti po puslapį JSON formatu.
Kai norite **viso rezultatų rinkinio kaip failo**, naudokite **eksporto** galinį
tašką – jis pateikia duomenis pasirinktu formatu be puslapiavimo.

<MethodPath method="POST" path="/namespaces/{namespace}/tables/{tableName}/export" />

<Callout title="Toks pat kūnas kaip užklausoje">
  Eksportas priima **tokį patį JSON užklausos kūną** kaip [užklausos galinis taškas](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
  – `select`, `filter`, `sort`, `limit`, `offset`, `exclude_nulls&#x60; – todėl bet kurią
  sudarytą užklausą galima eksportuoti. Vienintelis papildymas – &#x2A;*`format`**
  užklausos parametras, nurodantis failo tipą. Praleiskite kūną (`{}`), kad
  eksportuotumėte visą lentelę.
</Callout>

## Formatai [#formatai]

Nustatykite `format` užklausos parametrą. `ndjson` yra numatytasis:

<ParamTable
  lang="lt"
  params="[
  { name: &#x22;ndjson&#x22;, type: &#x22;numatytasis&#x22;, description: &#x22;Naujos eilutės atskirtas JSON – vienas objektas eilutėje, tinka srautiniam apdorojimui.&#x22; },
  { name: &#x22;json&#x22;, type: &#x22;formatas&#x22;, description: &#x22;Eilučių objektų JSON srautas.&#x22; },
  { name: &#x22;csv&#x22;, type: &#x22;formatas&#x22;, description: &#x22;Kableliais atskirtos reikšmės – antraštės eilutė ir duomenys.&#x22; },
  { name: &#x22;xlsx&#x22;, type: &#x22;formatas&#x22;, description: &#x22;Microsoft Excel darbaknygė. Ribojama iki 1 000 000 eilučių – didesnes lenteles filtruokite arba puslapiuokite.&#x22; },
  { name: &#x22;parquet&#x22;, type: &#x22;formatas&#x22;, description: &#x22;Stulpelinis dvejetainis – mažiausias ir greičiausias analitikai.&#x22; },
]"
/>

```bash
# Visa lentelė kaip NDJSON
curl -L -o toksikologija.ndjson \
  -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/export?format=ndjson' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

```json
{"_id":"11939610733872445230","vda_id":"166d143f8929ba0","pavadinimas":"Etanolis (etilo alkoholis)","lytis":"Moteris","mirties_metai":2021, …}
{"_id":"00016506519020014367","vda_id":"4f277520b7ccca2","pavadinimas":"Etanolis (etilo alkoholis)","lytis":"Vyras","mirties_metai":2019, …}
```

Pakeiskite į `format=csv`, `format=json`, `format=xlsx` arba `format=parquet`, kad
gautumėte kitą failo tipą, ir atitinkamai pakeiskite išvesties failo pavadinimą.
`xlsx` (Excel) formatas ribojamas iki **1 000 000 eilučių** – didesnes lenteles
susiaurinkite su `filter` arba `limit`.

## Pasirinkti stulpeliai ir filtrai [#pasirinkti-stulpeliai-ir-filtrai]

Kadangi eksportas naudoja tą patį užklausos kūną, susiaurinkite eksportą su
`select` ir `filter` lygiai taip pat kaip užklausą – [užklausų vadove](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
aprašyta visa filtro gramatika:

```bash
# Tik trys stulpeliai, mirusios moterys, kaip NDJSON
curl -L -o subset.ndjson \
  -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/export?format=ndjson' \
  -H 'Content-Type: application/json' \
  -d '{"select":"lytis,mirties_metai,pavadinimas","filter":"lytis=Moteris"}'
```

## Užklausos kūnas [#užklausos-kūnas]

<ParamTable
  lang="lt"
  params="[
  { name: &#x22;select&#x22;, type: &#x22;string&#x22;, description: &#x22;Kableliais atskirti įtraukiami stulpeliai. Praleiskite visiems.&#x22; },
  { name: &#x22;filter&#x22;, type: &#x22;string&#x22;, description: &#x22;Filtro išraiška – tokia pat gramatika kaip užklausos galiniame taške.&#x22; },
  { name: &#x22;sort&#x22;, type: &#x22;string&#x22;, description: &#x22;Kableliais atskirti raktai. Prefiksas - – mažėjančiai.&#x22; },
  { name: &#x22;limit&#x22;, type: &#x22;int&#x22;, description: &#x22;Apriboti į failą įrašomų eilučių skaičių.&#x22; },
  { name: &#x22;offset&#x22;, type: &#x22;int&#x22;, default: &#x22;0&#x22;, description: &#x22;Praleidžiamos eilutės prieš įrašymą.&#x22; },
  { name: &#x22;exclude_nulls&#x22;, type: &#x22;string[]&#x22;, description: &#x22;Stulpeliai, kurie turi būti ne-null; eilutės su null ten pašalinamos.&#x22; },
]"
/>

<Callout type="info" title="format užklausos parametras">
  `format` rašomas URL adrese kaip užklausos eilutė (`?format=ndjson`), o ne JSON
  kūne. Kūne perduodami tik aukščiau nurodyti užklausos laukai.
</Callout>

## Failų atsisiuntimas [#failų-atsisiuntimas]

Su vardų erdve susieti saugomi failai (PDF, paveikslėliai, archyvai) atsisiunčiami
pagal pavadinimą. Failo pavadinimas yra vienas bazinis vardas – jame negali būti
`/`.

<MethodPath method="GET" path="/namespaces/{namespace}/files/{fileName}" />

```bash
curl -L -O 'https://api.dataportal.gov.lt/namespaces/{namespace}/files/report.pdf'
```

Atsakymas yra neapdoroti baitai su išsaugotu pirminiu `Content-Type` ir failo
pavadinimu.

<Cards>
  <Card title="Užklausos į lenteles" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/querying" description="Skaitykite eilutes kaip puslapiuotą JSON, o ne masinį failą." />

  <Card title="Klaidos" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/errors" description="Būsenos kodai ir klaidų struktūros." />
</Cards>

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
* [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors)
* [Eksportuoti lentelės eilutes](https://guides.dataportal.gov.lt/lt/docs/api/tables/exportTable)
* [Atsisiųsti failą iš objektų saugyklos](https://guides.dataportal.gov.lt/lt/docs/api/files/downloadFile)


# Pavyzdžiai (https://guides.dataportal.gov.lt/lt/docs/api/guides/recipes)



Trumpi, veikiantys atsakymai į dažnus klausimus – visi su gyva pavyzdine lentele
`mirusiuju_toksikologinis_rezultatas` vardų erdvėje `111958286`. Įrašykite savo
vardų erdvę ir lentelę, ir jie veiks toliau.

## Suskaičiuoti, kiek eilučių atitinka – jų neatsisiunčiant [#suskaičiuoti-kiek-eilučių-atitinka--jų-neatsisiunčiant]

Paprašykite vienos eilutės ir perskaitykite `total`; jis atspindi **filtruotą**
rinkinį, todėl tai pigiausias būdas įvertinti užklausos dydį.

<CodeTabs labels="[&#x22;cURL&#x22;, &#x22;Python&#x22;, &#x22;JavaScript&#x22;]">
  ```bash
  curl -s -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query' \
    -H 'Content-Type: application/json' \
    -d '{"filter":"lytis=Moteris","limit":1}' | jq '.total'
  ```

  ```python
  import requests

  URL = "https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query"
  total = requests.post(URL, json={"filter": "lytis=Moteris", "limit": 1}).json()["total"]
  print(total, "eilučių atitinka")
  ```

  ```js
  const URL = "https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query";
  const { total } = await fetch(URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ filter: "lytis=Moteris", limit: 1 }),
  }).then((r) => r.json());
  console.log(total, "eilučių atitinka");
  ```
</CodeTabs>

## Gauti tik reikiamus stulpelius [#gauti-tik-reikiamus-stulpelius]

```bash
curl -X POST '…/query' -H 'Content-Type: application/json' \
  -d '{"select":"lytis,mirties_metai,pavadinimas","limit":20}'
```

## Trys filtravimo būdai [#trys-filtravimo-būdai]

```bash
# Tiksli atitiktis
-d '{"filter":"lytis=Moteris"}'

# Intervalas – mirtys nuo 2018 m.
-d '{"filter":"mirties_metai._ge=2018"}'

# Yra tarp – medžiagos pavadinime yra „Etan"
-d '{"filter":"pavadinimas._co=Etan"}'
```

## Sujungti sąlygas (IR / ARBA) [#sujungti-sąlygas-ir--arba]

Junkite sąlygas `filter` eilutėje su `&`; kiekviena papildoma pagal nutylėjimą yra
`_and`, arba prieš ją rašykite `_or.`, kad gautumėte disjunkciją.

```bash
# Nuo 2018 m. IR moteris
-d '{"filter":"mirties_metai._ge=2018&_and.lytis=Moteris"}'

# moteris ARBA vyras
-d '{"filter":"lytis=Moteris&_or.lytis=Vyras"}'
```

## Naujausios viršuje [#naujausios-viršuje]

```bash
curl -X POST '…/query' -H 'Content-Type: application/json' \
  -d '{"sort":"-mirties_metai","limit":10}'
```

## Pereiti visą lentelę puslapiais [#pereiti-visą-lentelę-puslapiais]

Visada pridėkite pastovų `sort` (pvz., `_id`), kad poslinkio puslapiavimas
nepraleistų ir nepakartotų eilučių. Sustokite, kai puslapis grąžina mažiau nei
`limit` eilučių.

<CodeTabs labels="[&#x22;Python&#x22;, &#x22;JavaScript&#x22;]">
  ```python
  import requests

  URL = "https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query"
  limit, offset = 1000, 0
  rows = []
  while True:
      page = requests.post(URL, json={"limit": limit, "offset": offset, "sort": "_id"}).json()["data"]
      rows += page
      if len(page) < limit:
          break
      offset += limit
  print(len(rows), "eilučių iš viso")
  ```

  ```js
  const URL = "https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/query";
  const limit = 1000;
  let offset = 0, rows = [];
  while (true) {
    const page = await fetch(URL, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ limit, offset, sort: "_id" }),
    }).then((r) => r.json());
    rows.push(...page.data);
    if (page.data.length < limit) break;
    offset += limit;
  }
  console.log(rows.length, "eilučių iš viso");
  ```
</CodeTabs>

<Callout type="info" title="Reikia visko? Geriau eksportuokite.">
  Norėdami viso rinkinio, iš viso nepuslapiuokite – [eksporto galinis taškas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)
  pateikia visą rezultatų rinkinį viena užklausa.
</Callout>

## Eksportuoti visą lentelę į Excel [#eksportuoti-visą-lentelę-į-excel]

`xlsx` ribojamas iki 1 000 000 eilučių; didesnes lenteles filtruokite arba naudokite `limit`.

```bash
curl -L -o toksikologija.xlsx \
  -X POST 'https://api.dataportal.gov.lt/namespaces/111958286/tables/mirusiuju_toksikologinis_rezultatas/export?format=xlsx' \
  -H 'Content-Type: application/json' -d '{}'
```

## Eksportuoti tik filtruotą dalį [#eksportuoti-tik-filtruotą-dalį]

Eksportas naudoja tą patį užklausos kūną, todėl bet kurią užklausą galima eksportuoti:

```bash
curl -L -o moterys.csv \
  -X POST '…/export?format=csv' -H 'Content-Type: application/json' \
  -d '{"select":"lytis,mirties_metai,pavadinimas","filter":"lytis=Moteris"}'
```

## Atsisiųsti saugomą failą [#atsisiųsti-saugomą-failą]

```bash
curl -L -O 'https://api.dataportal.gov.lt/namespaces/{namespace}/files/report.pdf'
```

<Cards>
  <Card title="Užklausos į lenteles" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/querying" description="Visa gramatika, kuria remiasi šie pavyzdžiai." />

  <Card title="Klaidos" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/errors" description="Ką reiškia kiekvienas būsenos kodas ir kaip jį tvarkyti." />
</Cards>

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
* [Duomenų ir failų atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)
* [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors)
* [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)


# Klaidos (https://guides.dataportal.gov.lt/lt/docs/api/guides/errors)



API naudoja standartinius HTTP būsenos kodus. `2xx` reiškia sėkmę; bet kas kita
turi klaidos turinį, o **turinio forma priklauso nuo to, kuris sluoksnis suklydo**.
Pasirinkite būsenos kodą žemiau ir pamatysite, kada jis įvyksta, ką tiksliai
grąžina API ir kaip tai tvarkyti.

<ErrorExplorer
  lang="lt"
  errors="[
  {
    code: 400,
    name: &#x22;Bad Request&#x22;,
    cause: &#x22;Užklausos kūnas netinkamas dar prieš vykdant užklausą – dažniausiai limit arba offset nėra skaičius.&#x22;,
    body: {
      type: &#x22;https://tools.ietf.org/html/rfc9110#section-15.5.1&#x22;,
      title: &#x22;One or more validation errors occurred.&#x22;,
      status: 400,
      errors: { &#x22;$.limit&#x22;: [&#x22;The JSON value could not be converted to System.Int32.&#x22;] },
      traceId: &#x22;00-ffc84beb047191d9…-00&#x22;,
    },
    fix: &#x22;Siųskite tinkamą JSON su teisingais tipais (limit ir offset yra skaičiai, ne eilutės). errors objektas nurodo kiekvieną klaidingą lauką pagal jo JSON kelią.&#x22;,
  },
  {
    code: 404,
    name: &#x22;Not Found&#x22;,
    cause: &#x22;Kelyje nurodyta vardų erdvė, lentelė ar failas neegzistuoja.&#x22;,
    body: {
      message: &#x22;NoSuchTableException: Table does not exist: 111958286.nope&#x22;,
      error_code: &#x22;TABLE_NOT_FOUND&#x22;,
    },
    fix: &#x22;Įprasta naršant. Patikrinkite pavadinimus – vardų erdvės lenteles išvardykite su GET /namespaces/{namespace}. error_code yra NAMESPACE_NOT_FOUND, TABLE_NOT_FOUND arba FILE_NOT_FOUND.&#x22;,
  },
  {
    code: 422,
    name: &#x22;Unprocessable&#x22;,
    cause: &#x22;Kūnas yra tinkamas JSON, bet nepraeina schemos validacijos (apribojimai aprašyti OpenAPI specifikacijoje).&#x22;,
    body: {
      type: &#x22;https://tools.ietf.org/html/rfc9110#section-15.5.21&#x22;,
      title: &#x22;One or more validation errors occurred.&#x22;,
      status: 422,
      errors: { &#x22;$.offset&#x22;: [&#x22;Must be greater than or equal to 0.&#x22;] },
    },
    fix: &#x22;Pataisykite lauką, į kurį rodo atsakymas, ir kartokite.&#x22;,
  },
  {
    code: 502,
    name: &#x22;Bad Gateway&#x22;,
    cause: &#x22;Užklausų variklis atmetė arba negalėjo įvykdyti užklausos – netinkama filtro išraiška, nežinomas stulpelis arba triraidis operatorius kaip ._gte. Taip pat laikinas pirminio šaltinio sutrikimas.&#x22;,
    body: &#x22;error code: 502&#x22;,
    fix: &#x22;Jei tai jūsų užklausa, pataisykite: dviraidžiai operatoriai (._ge, ne ._gte), tikri stulpelių pavadinimai, teisinga filtro gramatika. Jei užklausa teisinga, tai laikina – kartokite su atidėjimu.&#x22;,
  },
  {
    code: 503,
    name: &#x22;Service Unavailable&#x22;,
    cause: &#x22;Objektų saugykla laikinai nepasiekiama – paveikia failų atsisiuntimą ir eksportą.&#x22;,
    body: &#x22;error code: 503&#x22;,
    fix: &#x22;Laikina. Kartokite su atidėjimu.&#x22;,
  },
  {
    code: 504,
    name: &#x22;Gateway Timeout&#x22;,
    cause: &#x22;Pirminė užklausa užtruko per ilgai – dažnai dėl labai gilaus poslinkio arba didelio nefiltruoto nuskaitymo.&#x22;,
    body: &#x22;error code: 504&#x22;,
    fix: &#x22;Susiaurinkite rezultatą filtru, sumažinkite poslinkio gylį arba eksportuokite lentelę, o ne giliai puslapiuokite. Kartokite su atidėjimu.&#x22;,
  },
]"
/>

<Callout title="Iš kur ateina forma">
  * **`{ message, error_code }`** – duomenų sluoksnis (pvz., `404` trūkstamai lentelei).
  * **`{ error, error_code }`** – programos klaidos objektas, aprašytas OpenAPI specifikacijoje.
  * **`error code: NNN`** (grynas tekstas) – sąsajos lygio `5xx`, kuris nepasiekė programos.
  * **RFC 9110 problemos dokumentas** – užklausos validacija (`400` / `422`), klaidingi laukai po `errors`.

  Kai yra, skaitykite `error_code` dėl pastovios mašininės priežasties ir grįžkite
  prie žmogui skirtos žinutės.
</Callout>

## Kas dažniausiai nustebina [#kas-dažniausiai-nustebina]

**Netinkamas `filter` arba nežinomas stulpelis grąžina `502`, o ne `400`.** Filtras
perduodamas tiesiai užklausų varikliui, todėl jį atmeta variklis, o ne užklausos
validatorius. Taigi:

* Netinkamas operatorius (`._gte`) ar stulpelio pavadinimas → **502**, turinys `error code: 502`.
* Netinkamas reikšmės tipas (`limit: "abc"`) → **400**, aukščiau parodytas RFC problemos dokumentas.

Tikslią filtro gramatiką rasite skiltyje [Užklausos](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying).

## Klaidų tvarkymas [#klaidų-tvarkymas]

* **Pirmiausia patikrinkite būsenos kodą**, tada analizuokite turinį pagal aukščiau pateiktas formas.
* `404` yra įprasta naršant – vardų erdvė tiesiog gali neturėti tokios lentelės.
* `502` / `503` / `504` atveju kartokite su atidėjimu – bet pirma atmeskite netinkamą
  užklausą (tai tas pats kodas, kurį variklis grąžina esant netinkamam filtrui).

<Cards>
  <Card title="Užklausos į lenteles" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/querying" description="Filtro operatoriai ir _and/_or gramatika." />

  <Card title="Pavyzdžiai" href="https://guides.dataportal.gov.lt/lt/docs/api/guides/recipes" description="Kopijuojami sprendimai dažnoms užduotims." />
</Cards>

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
* [Duomenų ir failų atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)
* [Pavyzdžiai](https://guides.dataportal.gov.lt/lt/docs/api/guides/recipes)


# Vardų erdvių sąrašas arba šaknies erdvės (https://guides.dataportal.gov.lt/lt/docs/api/namespaces/listNamespaces)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document="&#x22;./openapi/dataapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/namespaces&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)


# Vardų erdvės duomenys (https://guides.dataportal.gov.lt/lt/docs/api/namespaces/getNamespace)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document="&#x22;./openapi/dataapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/namespaces/{namespace}&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)


# Gauti lentelės schemą (https://guides.dataportal.gov.lt/lt/docs/api/tables/getTableSchema)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document="&#x22;./openapi/dataapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/namespaces/{namespace}/tables/{tableName}/schema&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)
* [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)


# Užklausa į lentelės eilutes (https://guides.dataportal.gov.lt/lt/docs/api/tables/queryTable)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document="&#x22;./openapi/dataapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/namespaces/{namespace}/tables/{tableName}/query&#x22;,&#x22;method&#x22;:&#x22;post&#x22;}]" />

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Užklausos į lenteles](https://guides.dataportal.gov.lt/lt/docs/api/guides/querying)
* [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors)


# Eksportuoti lentelės eilutes (https://guides.dataportal.gov.lt/lt/docs/api/tables/exportTable)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document="&#x22;./openapi/dataapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/namespaces/{namespace}/tables/{tableName}/export&#x22;,&#x22;method&#x22;:&#x22;post&#x22;}]" />

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Duomenų ir failų atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)
* [Klaidos](https://guides.dataportal.gov.lt/lt/docs/api/guides/errors)


# Atsisiųsti failą iš objektų saugyklos (https://guides.dataportal.gov.lt/lt/docs/api/files/downloadFile)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document="&#x22;./openapi/dataapi.json&#x22;" operations="[{&#x22;path&#x22;:&#x22;/namespaces/{namespace}/files/{fileName}&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />

## Taip pat žiūrėkite [#taip-pat-žiūrėkite]

* [Duomenų ir failų atsisiuntimas](https://guides.dataportal.gov.lt/lt/docs/api/guides/downloading)
* [Sąvokos](https://guides.dataportal.gov.lt/lt/docs/api/guides/concepts)


# Dokumentacija DI asistentams (https://guides.dataportal.gov.lt/lt/docs/mcp)



Prijunkite šią dokumentaciją prie savo dirbtinio intelekto (DI) asistento — *Claude*, *ChatGPT*, *Copilot*, *Cursor* ar kito. Tada, paklausus apie portalą, asistentas atsakymą susiras šiame vadove ir pateiks nuorodą į puslapį.

<McpEndpoint url="https://guides.dataportal.gov.lt/api/mcp">
  * **Be prisijungimo.** Serveris viešas, raktų nereikia.
  * **Tik skaitymui.** Asistentas ieško ir skaito, bet nieko nekeičia.
  * **Visada aktualus.** Tas pats turinys, kurį matote svetainėje.
</McpEndpoint>

## Kas yra MCP? [#kas-yra-mcp]

**MCP** (*Model Context Protocol*) — atviras standartas, kuriuo DI asistentai jungiasi prie išorinių šaltinių ir įrankių. Jį 2024 m. pristatė *Anthropic*, o dabar palaiko dauguma didžiųjų DI įrankių. Pavadinimą verta išskaidyti:

<Acronym>
  <AcronymPart letter="M" word="Model" gloss="modelis">
    Kalbos modelis — DI asistento „smegenys". Jis daug žino, bet tik tai, ko išmoko iki tam tikros datos.
  </AcronymPart>

  <AcronymPart letter="C" word="Context" gloss="kontekstas">
    Informacija, kurią modelis mato atsakydamas. Kuo tikslesnis kontekstas, tuo tikslesnis atsakymas.
  </AcronymPart>

  <AcronymPart letter="P" word="Protocol" gloss="protokolas">
    Bendros taisyklės, kaip modelis kreipiasi į išorinį šaltinį: ko paklausti ir kokio atsakymo laukti.
  </AcronymPart>
</Acronym>

MCP dažnai lyginamas su *USB-C* jungtimi: vienas kištukas tinka daugybei įrenginių. Taip ir čia — šią dokumentaciją prijungiame vieną kartą, o ja naudotis gali bet kuris MCP palaikantis asistentas.

**Kam to reikia?** Be ryšio su šaltiniu asistentas atsako iš atminties. Portalas galėjo pasikeisti po to, kai modelis buvo apmokytas, o mygtuko pavadinimą ar API parametrą jis gali tiesiog išsigalvoti. Su MCP asistentas pirmiausia pasitikrina šiame vadove, o atsakymą pagrindžia nuoroda, kurią galite atsiversti patys:

<Flow>
  <FlowStep icon="message" title="Klausiate">
    „Kaip atsisiųsti tik išfiltruotas eilutes?"
  </FlowStep>

  <FlowStep icon="search" title="Asistentas ieško">
    Per MCP ieško šioje dokumentacijoje.
  </FlowStep>

  <FlowStep icon="file" title="Skaito puslapį">
    Gauna aktualų vadovo tekstą.
  </FlowStep>

  <FlowStep icon="sparkles" title="Atsako su nuoroda">
    Atsakymas remiasi vadovu — galite pasitikrinti.
  </FlowStep>
</Flow>

## Kaip prijungti [#kaip-prijungti]

<Tabs items="[&#x22;Claude&#x22;, &#x22;Claude Code&#x22;, &#x22;ChatGPT&#x22;, &#x22;Cursor&#x22;, &#x22;VS Code&#x22;, &#x22;Kiti&#x22;]">
  <Tab value="Claude">
    *claude.ai* svetainėje ar *Claude* programėlėje:

    <Steps>
      <Step>
        Atverkite **Settings → Connectors** ir spustelėkite **Add custom connector**.
      </Step>

      <Step>
        Įrašykite pavadinimą (pavyzdžiui, *LDP dokumentacija*) ir serverio adresą `https://guides.dataportal.gov.lt/api/mcp`. Autentifikacijos laukų nepildykite.
      </Step>

      <Step>
        Spustelėkite **Add*&#x2A;. Pokalbyje, mygtuke &#x2A;*+** arba įrankių meniu, įjunkite šią jungtį.
      </Step>
    </Steps>

    Savų jungčių pridėjimas priklauso nuo *Claude* plano ir organizacijos nustatymų.
  </Tab>

  <Tab value="Claude Code">
    Terminale:

    ```bash
    claude mcp add --transport http ldp-docs https://guides.dataportal.gov.lt/api/mcp
    ```

    Patikrinkite komanda `claude mcp list` arba sesijoje — `/mcp`.
  </Tab>

  <Tab value="ChatGPT">
    <Steps>
      <Step>
        Atverkite **Settings → Apps & Connectors → Advanced settings** ir įjunkite **Developer mode**.
      </Step>

      <Step>
        Grįžę į **Apps & Connectors**, spustelėkite **Create**, įrašykite pavadinimą ir serverio adresą, autentifikacijai pasirinkite **No authentication**.
      </Step>

      <Step>
        Pokalbyje jungtį pasirinkite per mygtuką &#x2A;*+**.
      </Step>
    </Steps>

    Kūrėjo režimas pasiekiamas ne visuose *ChatGPT* planuose.
  </Tab>

  <Tab value="Cursor">
    Faile `.cursor/mcp.json` (projektui) arba `~/.cursor/mcp.json` (visiems projektams):

    ```json
    {
      "mcpServers": {
        "ldp-docs": {
          "url": "https://guides.dataportal.gov.lt/api/mcp"
        }
      }
    }
    ```

    Tada **Cursor Settings → MCP** patikrinkite, ar serveris įjungtas.
  </Tab>

  <Tab value="VS Code">
    Su *GitHub Copilot* — faile `.vscode/mcp.json`:

    ```json
    {
      "servers": {
        "ldp-docs": {
          "type": "http",
          "url": "https://guides.dataportal.gov.lt/api/mcp"
        }
      }
    }
    ```

    Arba komandų paletėje pasirinkite **MCP: Add Server** ir įveskite adresą. Įrankius rasite *Copilot Chat* agento režimu.
  </Tab>

  <Tab value="Kiti">
    Tinka bet kuri programa, palaikanti MCP per **Streamable HTTP** — nurodykite serverio adresą.

    Jei programa palaiko tik vietinius (*stdio*) serverius, naudokite tarpininką `mcp-remote` (reikia *Node.js*):

    ```json
    {
      "mcpServers": {
        "ldp-docs": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://guides.dataportal.gov.lt/api/mcp"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Ko paklausti [#ko-paklausti]

Prijungę klauskite įprastai — asistentas pats nuspręs, kada ieškoti dokumentacijoje:

<Prompts>
  <Prompt>
    Kaip dataportal.gov.lt atsisiųsti tik išfiltruotas eilutes XLSX formatu?
  </Prompt>

  <Prompt>
    Ką reiškia brūkšnelis duomenų lentelėje?
  </Prompt>

  <Prompt>
    Kaip leidybos kalendoriuje rasti artimiausius leidimus ir įsidėti datą į savo kalendorių?
  </Prompt>

  <Prompt>
    Parašyk Python kodą, kuris per API gauna visas lentelės eilutes, ne tik pirmą puslapį.
  </Prompt>
</Prompts>

<Callout title="Kalbos">
  Dokumentacijos paieška apima ir lietuvišką, ir anglišką puslapių tekstą, o atsakymą pateikia ta kalba, kuria klausiate — net jei klausime vartojate kitos kalbos terminą, pavyzdžiui, portalo mygtuko pavadinimą. Pačio portalo oficialiosios statistikos duomenys pateikiami abiem kalbomis — lietuviškai ir angliškai, tad duomenų galite ieškoti ir juos gauti jums patogesne kalba.
</Callout>

## Asistento įrankiai [#asistento-įrankiai]

Serveris asistentui suteikia tris įrankius. Jie apima ir [naudotojo vadovą](https://guides.dataportal.gov.lt/lt/docs/guide), ir [Duomenų API dokumentaciją](https://guides.dataportal.gov.lt/lt/docs/api), abiem kalbomis.

<Features>
  <Feature icon="search" title="search_docs">
    Ieško dokumentacijoje — ta pati paieška kaip svetainėje, abiem kalbomis; puslapius grąžina klausimo kalba.
  </Feature>

  <Feature icon="file" title="get_page">
    Perskaito visą puslapį — tekstą, lenteles ir ekrano nuotraukų aprašus.
  </Feature>

  <Feature icon="list" title="list_pages">
    Parodo visų puslapių sąrašą ta tvarka, kaip meniu.
  </Feature>
</Features>

## Privatumas [#privatumas]

Serveriui nereikia prisijungti, jis nenaudoja slapukų ir tik skaito viešą dokumentaciją.

* **Serverį pasiekia** tik tai, ką asistentas įrašo į įrankio užklausą — paieškos žodžiai ar puslapio adresas, o ne jūsų pokalbis.
* **Kas saugoma:** kai paieška ar puslapio užklausa nieko neranda, užregistruojami jos žodžiai ir kalba — be jokių duomenų apie klausiantįjį, kad trūkstamas temas būtų galima papildyti.
* Kaip ir visuose šios svetainės puslapiuose, serveriai saugo įprastus techninius prieigos žurnalus.

Patį pokalbį tvarko jūsų DI asistento teikėjas pagal savo sąlygas. Daugiau — portalo [privatumo politikoje](https://dataportal.gov.lt/lt/privacy-policy).

## Be MCP [#be-mcp]

Jei jūsų įrankis MCP nepalaiko, dokumentaciją galima pateikti ir kitaip:

<Features>
  <Feature icon="copy" title="Vienas puslapis">
    Mygtukas **Kopijuoti Markdown** puslapio viršuje. Arba prie puslapio adreso pridėkite `.mdx`.
  </Feature>

  <Feature icon="list" title="Turinio sąrašas">
    [`llms.txt`](https://guides.dataportal.gov.lt/llms.txt) — visi puslapiai su trumpais aprašais ir nuorodomis.
  </Feature>

  <Feature icon="book" title="Viskas viename faile">
    [`llms-full.txt`](https://guides.dataportal.gov.lt/llms-full.txt?lang=lt) — visa dokumentacija lietuviškai. Yra ir [angliškai](https://guides.dataportal.gov.lt/llms-full.txt?lang=en).
  </Feature>
</Features>

<Tips>
  * **Norite išbandyti serverį?** Paleiskite `npx @modelcontextprotocol/inspector`, pasirinkite **Streamable HTTP**, įrašykite serverio adresą ir iškvieskite įrankius patys.
  * **Asistentas neranda atsakymo?** Paprašykite jo tiesiogiai: „paieškok dataportal dokumentacijoje".
</Tips>