DVV

Open data services

Subsystem information

Service bus identifier

FI.GOV.0245437-2.avoindata

Description

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://palveluhallinta.suomi.fi/fi/sivut/palvelutietovaranto/esittely/

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/

Attachments

Keywords

Additional Info

Field Value
Description

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://palveluhallinta.suomi.fi/fi/sivut/palvelutietovaranto/esittely/

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/

Keywords
Valid since
Valid until
Maintainer palveluvayla@palveluvayla.fi
Maintainer Email palveluvayla@palveluvayla.fi
Maintainer phone number
Data Exchange Layer environment (X-Road instance) FI
Organisation type (X-Road member class) GOV
Organisation code (Business ID, X-Road member code) 0245437-2
Organisation code (Business ID, X-Road member code) avoindata
Access Restriction Level Public
Allowed Organizations