Avoin data

Avoin rajapinta tarjoaa avoimuusrekisterissä julkaistujen ilmoitusten tiedot JSON-muodossa. Koneluettava data mahdollistaa käyttäjän omiin tarpeisiin sopivien räätälöityjen kyselyjen ja raporttien luomisen avoimuusrekisterin tiedoista.

Avoimuusrekisterin avointa rajapintaa käytetään OpenAPI (Swagger) -käyttöliittymän kautta. Rajapinta löytyy myös avoindata.fi-palvelusta.

Ennen rajapinnan käyttöä tulee tutustua sen käyttöehtoihin alta.

Avoimuusrekisterin avoimen rajapinnan käyttöehdot

Rajapinnan kuvaus ja käyttöoikeus

Avoimuusrekisterissä julkaistujen rekisteröinti-, toiminta- ja poistumisilmoituksien uusimmat versiot ovat saatavilla avoimen rajapinnan kautta. Lisäksi rajapinnan kautta saa tiedot ilmoituskausista, raportointijaksoista ja vaikuttamistoiminnan kohteista.

Rajapinnan kautta saatavaa dataa saa käyttää vapaasti, kun sen lähde merkitään CC BY 4.0 -lisenssin mukaisesti. Rajapinnan käyttö on maksutonta.

Rajapinta on tarkoitettu kevyisiin käyttötapauksiin, joissa suorituskyky ei ole kriittistä. Rajapintaa ei suositella suurten tietomäärien käsittelyyn, sillä kapasiteetin riittävyyttä ei taata.

Käytön rajoitukset

Tietoaineiston tuottaja voi rajoittaa yksittäisen käyttäjän pääsyä rajapintaan, jos käytön volyymi häiritsee palvelun toimintaa.

Vastuu

Rajapinnan käyttäjä käyttää avointa dataa omalla vastuullaan. Tietoaineiston tuottaja ei vastaa mistään välittömistä tai välillisistä vahingoista, joita datan käytöstä voi aiheutua. Tuottaja ei myöskään vastaa vahingoista, jotka johtuvat palvelun toimintakatkoksista.

Palvelun muutokset

Tietoaineiston tuottaja pidättää oikeuden tehdä muutoksia rajapinnan sisältöön, toiminnallisuuteen ja käyttöehtoihin. Muutoksista tiedotetaan osoitteessa www.avoimuusrekisteri.fi.

Lisenssi

Valtiontalouden tarkastusvirasto on tietoaineiston tuottaja ja tekijänoikeuden haltija. Tietoaineisto on lisensoitu Creative Commons Nimeä 4.0 -lisenssillä (CC BY 4.0).

Tietoaineistoa saa kopioida, muokata ja jakaa edelleen alkuperäisessä tai muutetussa muodossa. Sitä voi yhdistää muihin aineistoihin ja käyttää myös kaupallisiin tarkoituksiin.

Lisensoitua tietoaineistoa käytettäessä on mainittava lähdemerkinnässä ainakin seuraavat asiat:

• Aineiston tuottajan nimi

• Aineiston nimi ja linkki siihen

• Käytetyn lisenssin nimi ja linkki siihen

• Maininta, jos aineistoa on muokattu

Esimerkki: Valtiontalouden tarkastusvirasto, Avoimuusrekisterin tietoaineisto, CC BY 4.0.

Vastaanottamalla, lataamalla tai muuten saattamalla aineistoja käyttöönsä käyttäjä hyväksyy edellä mainitut käyttöehdot.

Ohjeita rajapinnan käyttöön

Rajapintaa käytetään OpenAPI (Swagger) -käyttöliittymän kautta. Avoimet rajapinnat tunnistaa ”open-data” merkinnästä rajapinnan nimen alussa.

”Register notification” tarkoittaa rekisteröinti-ilmoitusta, ”activity notification” toimintailmoitusta ja ”exit notification” poistumisilmoitusta.

Erityisesti toimintailmoituksiin liittyvien rajapintojen vastausnopeudessa voi ilmetä hitautta suuren datamäärän vuoksi.