This subsystem enables you to use the open data services offered by different organisations through the Data Exchange Layer.
Purpose of open data services
With the open data services you can test the connection of your Security Server to the Suomi.fi Data Exchange Layer and test the operation of REST messages.
Conditions for using the open data services
The test services are freely available for the customers of the Data Exchange Layer. The same test services work in the development, test and production environments of the Data Exchange Layer.
Using the open data services
Read more about how to use the test services and learn how to prepare test cases in the Data Exchange Layer test services support article.
REST query via the Data Exchange Layer:
Open data services are queried with REST.
Syntax for REST queries:
curl -k -X GET "https://[your own security server address]/r1/[X-Road instance environment ID]/[service provider’s member class]/[service provider’s member code]/avoindata/[requested service]/[service end url]" -H "accept: application/json" -H "X-Road-Client: [X-Road instance environment ID]/[your own member class]/[your own member code]/[your own subsystem ID]"
Example of a REST query
Please note! The abbreviations at the beginning of search paths refer to the development environment (FI-DEV), test environment (FI-TEST) and production environment (FI). Each search path can only be used in those environments.
List of available open data services
Finna open interface
Original address: https://api.finna.fi/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://www.kiwi.fi/display/Finna/Finnan+avoin+rajapinta
Finto open interface
Original address: https://api.finto.fi
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://api.finto.fi
The Government's open project interface (hankeikkuna)
Original address: https://api.hankeikkuna.fi/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://api.hankeikkuna.fi/api
Helsinki City Executive Office (information about Finland in many different languages) open interface
Original address: https://api.infopankki.fi/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://hri.fi/data/fi/dataset/tietoa-suomesta-monella-eri-kielella
Kirjastot.fi (libraries) open interface
Original address: https://api.kirjastot.fi/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://api.kirjastot.fi
Suomi.fi Finnish Service Catalogue open interface
Original address: https://api.palvelutietovaranto.suomi.fi/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://kehittajille.suomi.fi/services/servicecatalogue/what-is-suomi-fi-finnish-service-catalogue
Helsinki Region infoshare open interface
Original address: https://citynature.eu/
The REST search path offered in the Data Exchange Layer:
- /r1/FI-DEV/0245437-2/avoindata/citynature.eu/
- /r1/FI-TEST/0245437-2/avoindata/citynature.eu/
- /r1/FI/0245437-2/avoindata/citynature.eu/
Further information: https://hri.fi/data/fi/dataset/helsingin-ja-tallinnan-luontoreitit/
Vantaa Job Openings interface
Original address: https://gis.vantaa.fi/rest/tyopaikat/v1
The REST search path offered in the Data Exchange Layer:
- /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/
Further information:
Digitraffic open marine traffic interface
Original address: https://www.digitraffic.fi/meriliikenne/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://www.digitraffic.fi/meriliikenne/
Helsinki parking place usage interface
Original address: https://pubapi.parkkiopas.fi/public/v1/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information:
Digitraffic open rail traffic interface
Original address: https://rata.digitraffic.fi/
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://www.digitraffic.fi/rautatieliikenne/
Digitraffic open road traffic interface
Original address: https://tie.digitraffic.fi
The REST search path offered in the Data Exchange Layer:
- /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/
Further information: https://www.digitraffic.fi/tieliikenne/
Digitraffic vayla.fi open interface
Original address: https://vayla.fi/
The REST search path offered in the Data Exchange Layer:
- /r1/FI-DEV/0245437-2/avoindata/vayla.fi/
- /r1/FI-TEST/0245437-2/avoindata/vayla.fi/
- /r1/FI/0245437-2/avoindata/vayla.fi/
Further information: https://www.digitraffic.fi/tieliikenne/
