Tekninen kuvaus

WS-, SFTP- ja SMTP-rajapinnat suljetaan 1.1.2027

Suomi.fi-viestien vanhat rajapinnat (WS, SFTP ja SMTP) ovat ylläpitotilassa, eikä niihin enää tuoteta uusia toiminnallisuuksia. Kaikki vanhat rajapinnat suljetaan 1.1.2027.
Kaikkien Suomi.fi-viestejä käyttävien palvelujen täytyy siirtyä käyttämään REST-rajapintaa viimeistään 31.12.2026.

Organisaationne voi käyttää Suomi.fi-viestien lähettämiseen ja vastaanottamiseen REST-rajapintaa. Lisäksi voitte käyttää POST-rajapintaa loppukäyttäjien asiointipalvelussanne täyttämien lomakkeiden välittämiseen Suomi.fi-viesteille. Suomi.fi-viesteihin liitytään suoraliitynnän avulla sekä REST- että POST-rajapintaa käytettäessä.

Voitte tutustua rajapintoihin tarkemmin erillisillä rajapintojen alasivuilla. Voitte vertailla rajapintoja tämän lisäksi Rajapintojen ominaisuusluettelon avulla.

REST on Suomi.fi-viestien rajapinnoista uusin ja monipuolisin. Kaikki Toiminnallisuudet-osiossa kuvatut toiminnallisuudet ovat käytettävissä REST-rajapinnassa.

Tiedonvälitys REST-rajapinnassa perustuu yksisuuntaiseen integraatioon, jossa organisaationne järjestelmä kutsuu Suomi.fi-viestejä käytetystä toiminnallisuudesta riippumatta.

Lukekaa lisää tästä rajapinnasta REST-rajapinta-sivulla.

POST-rajapinta mahdollistaa loppukäyttäjien asiointipalvelussanne täyttämien lomakkeiden tietojen välittämisen ja säilyttämisen Suomi.fi-viesteissä.

POST-rajapintaa käytetään ainoastaan lomakkeen tietojen siirtämiseen asiointipalvelustanne Suomi.fi-viesteille. Tietojen siirtäminen perustuu POST-kutsuihin. Vastaanottaaksenne lomakkeen sisällön Suomi.fi-viesteiltä täytyy organisaationne ottaa POST-rajapinnan lisäksi käyttöön toinen vastausmahdollisuutta tukeva rajapinta.

Lukekaa lisää tästä rajapinnasta POST-rajapinta-sivulla. Lisäksi voitte tutustua lomakkeiden vastaanottamiseen toiminnallisuutena Viestien vastaanottaminen -sivulla.

Päivitetty: 13.8.2026