Käyttääkö organisaationne Suomi.fi-viestejä? Siirtymä Suomi.fi-viestien REST-rajapintaan pitää tehdä vuoden 2026 aikana

Kaikkien Suomi.fi-viestejä käyttävien organisaatioiden tulee siirtyä viimeistään vuoden 2026 aikana käyttämään Suomi.fi-viestien REST-rajapintaa. Suomi.fi-viestien muista rajapinnoista (WS, SMTP, SFTP) luovutaan. Niihin ei voi tehdä enää liityntöjä ja niistä pitää siirtyä REST-rajapintaan 31.12.2026 mennessä.

Jos organisaationne on ottamassa Suomi.fi-viestejä käyttöön loppuvuodesta 2025, liityntä tulee tehdä suoraan REST-rajapintaan. Näin liityntää ei tarvitse muuttaa heti vuoden 2026 aikana.

REST-rajapinta on Suomi.fi-viestien päärajapinta. Se tarjoaa käyttöönne kaikki Suomi.fi-viestien toiminnallisuudet. Rajapinnan toteutus on teknisesti moderni, ja siihen integroituminen on nopeaa ja yksinkertaista. Lisäksi REST-rajapinta mahdollistaa Suomi.fi-viestien vanhoja rajapintoja paremman toimintavarmuuden, virhesietoisuuden ja suorituskyvyn.

Siirtymäaikataulu REST-rajapintaan

​​​​​​​Huomioikaa nämä, jos organisaationne käyttää vielä Suomi.fi-viestejä WS-, SFTP- tai SMTP-rajapintojen kautta

Siirtymä REST-rajapintaan edellyttää toimenpiteitä organisaatioilta, jotka käyttävät Suomi.fi-viestejä WS-, SFTP- tai SMTP-rajapintojen kautta.

Tehtävät toimenpiteet ja niiden laajuus riippuvat siitä,

• mikä rajapinta on käytössä,
• mihin rajapintaa on käytetty ja
• miten rajapinta on toteutettu.

Jos käytätte Suomi.fi-viestejä järjestelmätoimittajan tarjoaman järjestelmän kautta, varmistakaa:

• että järjestelmässä on tuki viestien lähettämiseen REST-rajapinnan kautta
• että järjestelmä siirtyy käyttämään REST-rajapintaa viimeistään vuoden 2026 aikana

Olemme julkaisseet blogikirjoituksen Suomi.fi-viestejä käyttävien organisaatioiden ja Viestit-palvelun tarjoamiinsa ohjelmistoihin integroineiden välitoimijoiden tueksi. Blogissa avaamme, mitä REST-siirtymä tarkoittaa eri rajapintojen käyttäjille ja mitä siirtymän yhteydessä on hyvä ottaa huomioon.

Ohjeistus REST-rajapintaan siirtymiselle

Suomi.fi-viestien vanhoista rajapinnoista (WS, SFTP) siirtyminen uuteen REST-rajapintaan tapahtuu pitkälti samojen ohjeiden pohjalta kuin uuden palvelun käyttöönotto.  

REST-käyttöönoton vaiheet tiivistetysti:

• Palauttakaa palvelutietolomake → Saatte testiympäristön tunnukset.
• Testatkaa liityntä → Varmistakaa mm., että kokonaisprosessi vastaa tarpeitanne.
• Palauttakaa tarkistuslista → Saatte tuotantoympäristön tunnukset.
• Siirtykää käyttämään REST-rajapintaa.

Tutustukaa tarkemmin käyttöönoton ohjeeseen osoitteessa https://kehittajille.suomi.fi/palvelut/viestit/kayttoonotto/hallinnollinen-kayttoonotto

Lisätietoja

Digi- ja väestötietovirasto, Suomi.fi-viestien käyttöönottojen tuki, [email protected]