Finlexin aineistoja avoimena datana ohjelmallisesti tai käyttöliittymän kautta ladattavissa
Finlexin aineistot ovat saatavilla verkkopalvelun lisäksi myös avoimena datana. Aineistoja voi ladata sekä ohjelmallisesti REST-rajapinnan kautta tekemällä erilaisia hakuja että aineistokohtaisina paketteina käyttöliittymän kautta.
Avoimen datan dokumentit ovat Akoma Ntoso xml-muodossa ja sen mukaisessa kansiorakenteessa. Toteutus on kansainvälisestä standardista Finlexiin tehty sovitus.
REST-rajapinnan kautta ladattava aineisto päivittyy pienellä viiveellä dokumentin julkaisusta. Käyttöliittymän kautta ladattavat paketit päivittyvät kerran vuorokaudessa.
Tutustu REST-rajapintakuvaukseen ja esimerkkiin Akoma Ntoso xml-dokumentista. Tutustu myös Akoma Ntoso -skeemaan ja Akoma Ntoso -standardiin.
Pääset integraation toteuttamisessa alkuun seuraamalla pikaopasta.
Seuraavat muutokset on tehty Avoimen datan palveluun:
Aineistoille, joilla on xml- ja pdf-muotoinen sisältö, palautetaan xml-muotoinen esitys. Pelkän pdf-muotoisen esityksen sisältäville palautetaan xml-metadata, joka viittaa sisällön pdf-muotoiseen esitykseen.
Aineiston xml-, pdf- ja mediatiedostot zip-arkistona palauttavissa end pointeissa on muutettu zipin sisältämä hakemistorakenne siten, että pdf-tiedosto löytyy zipin juurihakemistosta erillisen alihakemiston sijaan.
End point akn/fi/act/<actDocumentType>/list listaa nyt myös ajantasaisten säädösten ajalliset versiot alkuperäisten kieliversioiden (ns. säädöskokoelma-versio) lisäksi.
Jos hakuparametrissa ei ole määritelty ajantasaisen säädöksen ajallista versiota (muoto esim. fin@<ajallinen versio>), palautetaan end pointeista alkuperäinen kieliversio (ns. säädöskokoelma-versio).
akn/fi/act/<actDocumentType>/list.End point /akn/fi/act/{actDocumentType}/{year}/{number}, jonka kautta voi palauttaa ajantasaisen säädöksen kaikki ajalliset versiot sisältää nyt sivutuksen riittävän pienellä sivukoolla. Tällöin saadaan haettua paljon ajallisia versioita sisältävät säädökset sivu kerrallaan ilman, että vastauksen koko kasvaa niin suureksi, että se aiheuttaa ongelmia.
Avoimen datan rajapinnan Swagger-ui käyttöliittymän xml-vastausten syntaksin korostus on poistettu käytöstä, jotta suurempien vastausten käsittely käyttöliittymässä olisi API:a testatessa nopeampaa.