Suomi.fi for Service Developers
Go directly to contents.

Retrieving register data to the Web Service

Using a Handlebars template in the Suomi.fi Web Service

Data from the client organisation’s register is retrieved to the Suomi.fi Web Service with a handlebars template.

The data items contained in the JSON file converted from the XML file retrieved from the client organisation’s register are displayed as a separate retrieval in the Web Service. The contents of the retrieval are coded according to the Handlebars template, where the data item is referred to with {{ }} brackets as shown in the example below. The client organisation can influence the presentation format by creating a template file or PowerPoint image, but the final version is made by the Digital and Population Data Services Agency’s development team.

The retrieval is not allowed to contain active content, but links to the client organisation’s service are allowed.

In the Web Service, a sample response converted from XML to JSON is as follows:

{
”nimi”:”Mallidata”,
”aika”:”TI 31.2.2016 15:00″,
”lisatieto”:”malliksi”
}

This, in turn, is displayed in the Suomi.fi Web Service with handlebars templating, for example as follows:

Your data in the system

  • Name: {{name}}
  • Date and time: {{date and time}}
  • Additional information about the service: {{additional information}}

Updated: 1/11/2024

Are you satisfied with the content on this page?