Käyttääkö organisaationne Suomi.fi-viestejä? Siirtymä Suomi.fi-viestien REST-rajapintaan pitää tehdä vuoden 2026 aikana
Julkaistu 10.11.2025
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
Milloin | Mitä |
|---|---|
1.1.2026 alkaen | Kaikki uudet liitynnät Suomi.fi-viesteihin tehdään REST-rajapintaan |
1.1.2027 | Vanhat rajapinnat suljetaan. Jokaisen Suomi.fi-viestejä käyttävän organisaation pitää olla siirtynyt käyttämään uutta REST-rajapintaa |
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, viestit-kayttoonotot@dvv.fi