Lähteet

Julkiset lähteet ja attribuutio

Palvelu rakennetaan virallisten ja julkisten lähteiden päälle. Jokainen näkyvä analyysi tarvitsee lähdeviitteet ja sisäisen evidenssikirjauksen — tässä on koko lähderekisteri lisensseineen.

Koodin käyttökohteet ja ajantasainen tila

Lähteiden käyttökohdekartta kuvaa toteutettuja näkymiä, tausta-aineistoja ja tunnettuja puutteita. Rekisterimerkintä ei todista aineiston ajantasaisuutta, kattavuutta tai julkaisulupaa. Tietokannasta haettavat tila- ja tuoreustiedot kuvaavat erikseen ajonaikaista tilannetta; puuttuva tilatieto ei tarkoita toimivaa lähdettä.

Julkinen elinkaarivaihe on koodin oletuksen ja uusimman tallennetun lähderivin vaiheista pidemmällä oleva. Yhtä pitkät vaiheet ovat tasan; puuttuva ajonaikainen vaihe jättää koodin oletuksen voimaan. Uusin rivi valitaan luontijärjestyksessä, ei viimeisimmän päivityksen mukaan. Hallinnan vaihekuvaaja näyttää tallennettujen rivien tilan sellaisenaan, joten se voi poiketa julkisesta rekisteristä. Elinkaarivaihe ei yksin varmista kattavuutta, tuoreutta tai julkaisulupaa.

Lähteiden käyttökohdekartta (tekninen dokumentaatio, uusi välilehti)

Lisenssit ja julkaisusäännöt

Julkaisusääntö kertoo, mitä Vahtikone näyttää lähteestä. Se ei ole yleinen lupa aineiston uudelleenkäyttöön. Tarkista alkuperäisen lähteen käyttöehdot ja mahdolliset aineistokohtaiset rajaukset.

Lähderivin lisenssilinkki avaa kyseisen lähteen rekisteriin merkityn sivuston, ei välttämättä erillistä lisenssisivua. Puuttuva linkki tai tuntematon sääntö ei tarkoita vapaata käyttöoikeutta.

Julkaistaan kokonaan: Lähteen sisältöä voidaan näyttää kokonaisena, kun näkymä sitä käyttää.
Vain metatiedot: Julkisessa näkymässä näytetään metatiedot ja lähdelinkki.
Vain johdettu tieto: Julkisessa näkymässä näytetään vain lähteestä johdettu yhteenveto tai laskenta.
Ei julkaista: Lähdettä ei julkaista julkisissa näkymissä.

Avoin data ja uudelleenkäyttö

Koneluettava rajapinta ja syötteet

Avoin JSON-rajapinta

Normalisoitu, lähteisiin sidottu data on uudelleenkäytettävissä koneluettavana. Jokainen tietue sisältää provenienssin (lähdetunniste, lähde-URL, mahdollinen tarkistesumma ja hakuaika). Rajapinta kattaa vain lähteet, joiden julkaisusääntö on ”julkaistaan kokonaan” (CC BY 4.0).

/api/v1Hakemisto — listaa kaikki avoimet aineistot
/api/v1/votesEduskunnan äänestykset
/api/v1/documentsEduskunnan asiakirjat
/api/v1/projectsHallituksen hankkeet (Hankeikkuna)

Sivutus parametreilla ?limit= (enintään 100) ja ?cursor=. Vastaukset välimuistitetaan noin minuutin ajan — pidäthän kyselytaajuuden kohtuullisena ja käytät kursoria sivuttaiseen hakuun.

RSS-syöte

”Suomi nyt” -tapahtumavirta on tilattavissa RSS 2.0 -syötteenä. Merkinnät linkittävät ensisijaisesti Vahtikoneen sisäiseen näkymään ja muuten alkuperäiseen lähteeseen. Uutismedioiden merkinnöistä julkaistaan vain otsikko, julkaisija, päiväys ja linkki alkuperäiseen uutiseen, ei uutisen sisältöä.

/nyt/feed.xml

AttribuutioCC BY 4.0

Uudelleenkäytössä on säilytettävä alkuperäisen lähteen attribuutio (esim. ”Lähde: Eduskunta avoin data” tai ”Lähde: Valtioneuvoston Hankeikkuna”) sekä viittaus Vahtikoneeseen aineiston yhdistäjänä. Jokaisen lähteen tarkka attribuutioteksti ja lisenssi näkyvät yllä olevassa lähderekisterissä.

Tietojen viennin rajat ja kehityssuunta

Nykyinen JSON-rajapinta tarjoaa valittuja julkisia tietoja eduskunnan äänestyksistä, asiakirjoista ja Hankeikkunan hankkeista. Se ei ole tietokannan kopio. Äänestysaineistossa on tapahtuman yhteisiä äänimääriä; rajapinta ei vie yksittäisten edustajien äänestysrivejä. Asiakirjoista ja hankkeista saa tunnisteita, otsikoita, ajankohtia ja lähdeviitteitä, ei kokotekstejä tai raakavastauksia.

Aloita aineistohakemistosta. Yhdellä sivulla on enintään 100 tietuetta. Jatka seuraavalla kursorilla niin kauan kuin vastaus ilmoittaa jatkosivun, myös tyhjän sivun jälkeen: julkaisurajaus voi jättää sivun ilman tietueita. Lähteen päivitys tai rajapinnan vastaus ei takaa aineiston täydellisyyttä. Virhetilanteen 503-vastausta ei pidä tulkita tyhjäksi aineistoksi.

Mitä emme avaa vientiin

Tekijänoikeudella suojattuja uutisten kokotekstejä, vaalikoneiden vapaatekstiselityksiä tai muita raakatekstejä ei sisällytetä näihin vientiaineistoihin. RSS jakaa otsikoita, tapahtumien metatietoja ja linkkejä, ei uutisartikkeleiden tekstejä.
Avaimet, kirjautumistunnukset, ympäristömuuttujat, palvelulokit ja sisäiset tarkastusmuistiinpanot eivät kuulu julkiseen vientiin.
Korjauspyyntöjen yhteystiedot, ilmoittajien tiedot tai muut yksityiset henkilötiedot eivät kuulu näihin aineistoihin. Julkisen asiakirjan otsikko voi silti sisältää henkilön nimen: rajapinta ei ole yleinen henkilötietojen anonymisointipalvelu.

Seuraavat mahdolliset aineistot

Arvioimme ensisijaisesti lähteisiin sidottuja lukumääriä ja jakaumia, esimerkiksi äänestysten määriä ajanjaksoittain tai hankkeiden määriä ministeriöittäin. Nämä ovat arvioitavia laajennuksia, eivät uusia julkaistuja rajapintoja tai toimituslupauksia.

Ennen laajennusta tarkistamme lähdekohtaiset käyttöehdot, attribuution, henkilötietojen ja pienten ryhmien tunnistamisriskin, aineiston rajaukset sekä päivitys- ja korjauskäytännön. Pelkkä lukumääräksi kokoaminen ei poista käyttöehtoja tai tunnistamisriskiä. Metatietoihin tai johdettuun tietoon rajattua lähdettä ei avata kokotekstivientiin tämän suunnitelman perusteella.

Tarkista lähteen lisenssi ja attribuutio yllä olevasta rekisteristä. Vahtikoneen julkaisusääntö ei yksin anna yleistä uudelleenkäyttölupaa.Lue menetelmä ja aineiston rajaukset · Ilmoita aineiston virheestä