Alijärjestelmä mahdollistaa eri organisaatioiden tarjoamien avoimen datan palvelujen hyödyntämisen Palveluväylän kautta.
Avoimen datan palveluiden tarkoitus
Avoimen datan palveluiden avulla voit testata liityntäpalvelimesi yhteyttä Suomi.fi-palveluväylään sekä REST-viestien toimintaa.
Palveluiden käytön edellytykset
Palvelut ovat vapaasti käytettävissä Palveluväylän asiakkaille. Samat palvelut toimivat Palveluväylän kehitys-, testi- ja tuotantoympäristöissä.
Avoimen datan palveluiden käyttäminen
Tutustu testipalveluiden käyttämiseen ja lue ohjeet testitapausten laatimiseen Palveluväylän testipalvelut -tukiartikkelista.
REST-kysely Palveluväylän kautta:
Avoimen datan palveluita kutsutaan REST-kyselyllä.
REST-kyselyn syntaksi:
curl -k -X GET "https://[oman liityntäpalvelimen osoite]/r1/[ [x-road instance ympäristötunnus]/[palveluntarjoajan member class]/[palveluntarjoajan member code]/avoindata/[kutsuttava palvelu]/[palvelun loppu url]" -H "accept: application/json" -H "X-Road-Client: [x-road instance ympäristötunnus]/[oma member class]/oma member code/[oma alijärjestelmätunnus]"
Esimerkki REST-kyselystä:
Huom! Lyhenteet hakupolkujen alussa tarkoittavat kehitysympäristöä (FI-DEV), testiympäristöä (FI-TEST) ja tuotantoympäristöä (FI). Kutakin hakupolkua voi käyttää vain kyseisissä ympäristöissä.
Saatavilla olevat avoimen datan rajapintapalvelut
Finna avoin rajapinta
Alkuperäinen osoite: https://api.finna.fi/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/api.finna.fi/
- /r1/FI-TEST/0245437-2/avoindata/api.finna.fi/
- /r1/FI/0245437-2/avoindata/api.finna.fi/
Lisätietoja: https://www.kiwi.fi/display/Finna/Finnan+avoin+rajapinta
Finto avoin rajapinta
Alkuperäinen osoite: https://api.finto.fi
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/api.finto.fi/
- /r1/FI-TEST/0245437-2/avoindata/api.finto.fi/
- /r1/FI/0245437-2/avoindata/api.finto.fi/
Lisätietoja: https://api.finto.fi
Valtioneuvoston avoin hankeikkuna rajapinta
Alkuperäinen osoite: https://api.hankeikkuna.fi/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/api.hankeikkuna.fi/
- /r1/FI-TEST/0245437-2/avoindata/api.hankeikkuna.fi/
- /r1/FI/0245437-2/avoindata/api.hankeikkuna.fi/
Lisätietoja: https://api.hankeikkuna.fi/api
Helsingin kaupunginkanslia (tietoa suomesta monella eri kielellä) avoin rajapinta
Alkuperäinen osoite: https://api.infopankki.fi/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/api.infopankki.fi/
- /r1/FI-TEST/0245437-2/avoindata/api.infopankki.fi/
- /r1/FI/0245437-2/avoindata/api.infopankki.fi/
Lisätietoja: https://hri.fi/data/fi/dataset/tietoa-suomesta-monella-eri-kielella
Kirjastot.fi avoin rajapinta
Alkuperäinen osoite: https://api.kirjastot.fi/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/api.kirjastot.fi/
- /r1/FI-TEST/0245437-2/avoindata/api.kirjastot.fi/
- /r1/FI/0245437-2/avoindata/api.kirjastot.fi/
Lisätietoja: https://api.kirjastot.fi
Palvelutietovaranto avoin rajapinta
Alkuperäinen osoite: https://api.palvelutietovaranto.suomi.fi/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/api.palvelutietovaranto.suomi.fi/
- /r1/FI-TEST/0245437-2/avoindata/api.palvelutietovaranto.suomi.fi/
- /r1/FI/0245437-2/avoindata/api.palvelutietovaranto.suomi.fi/
Lisätietoja: https://kehittajille.suomi.fi/palvelut/palvelutietovaranto/mika-on-palvelutietovaranto
Helsinki Region infoshare avoin rajapinta
Alkuperäinen osoite: https://citynature.eu/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/citynature.eu/
- /r1/FI-TEST/0245437-2/avoindata/citynature.eu/
- /r1/FI/0245437-2/avoindata/citynature.eu/
Lisätietoja: https://hri.fi/data/fi/dataset/helsingin-ja-tallinnan-luontoreitit/
Vantaan avoimet työpaikat rajapinta
Alkuperäinen osoite: https://gis.vantaa.fi/rest/tyopaikat/v1
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/gis.vantaa.fi/
- /r1/FI-TEST/0245437-2/avoindata/gis.vantaa.fi/
- /r1/FI/0245437-2/avoindata/gis.vantaa.fi/
Lisätietoja:
Digitraffic meriliikenteen avoin rajapinta
Alkuperäinen osoite: https://www.digitraffic.fi/meriliikenne/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/meri.digitraffic.fi/
- /r1/FI-TEST/0245437-2/avoindata/meri.digitraffic.fi/
- /r1/FI/0245437-2/avoindata/meri.digitraffic.fi/
Lisätietoja: https://www.digitraffic.fi/meriliikenne/
Helsingin pysäköintipaikkojen käytön rajapinta
Alkuperäinen osoite: https://pubapi.parkkiopas.fi/public/v1/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/pubapi.parkkiopas.fi/
- /r1/FI-TEST/0245437-2/avoindata/pubapi.parkkiopas.fi/
- /r1/FI/0245437-2/avoindata/pubapi.parkkiopas.fi/
Lisätietoja:
Digitraffic rataliikenteen avoin rajapinta
Alkuperäinen osoite: https://rata.digitraffic.fi/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/rata.digitraffic.fi/
- /r1/FI-TEST/0245437-2/avoindata/rata.digitraffic.fi/
- /r1/FI/0245437-2/avoindata/rata.digitraffic.fi/
Lisätietoja: https://www.digitraffic.fi/rautatieliikenne/
Digitraffic tieliikenteen avoin rajapinta
Alkuperäinen osoite: https://tie.digitraffic.fi
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/tie.digitraffic.fi/
- /r1/FI-TEST/0245437-2/avoindata/tie.digitraffic.fi/
- /r1/FI/0245437-2/avoindata/tie.digitraffic.fi/
Lisätietoja: https://www.digitraffic.fi/tieliikenne/
Digitraffic vayla.fi avoin rajapinta
Alkuperäinen osoite: https://vayla.fi/
Palveluväylässä tarjottava REST hakupolku:
- /r1/FI-DEV/0245437-2/avoindata/vayla.fi/
- /r1/FI-TEST/0245437-2/avoindata/vayla.fi/
- /r1/FI/0245437-2/avoindata/vayla.fi/
Lisätietoja: https://www.digitraffic.fi/tieliikenne/
