Suomi.fi-viestien käytössä siirrytään REST-rajapintaan – katso siirtymäajat! 

Suomi.fi-viestien käytössä siirrytään tulevina vuosina uuteen REST-rajapintaan. Tämän uuden rajapinnan kautta on mahdollista saada käyttöön ominaisuudet, jotka ovat olleet aiemmin Suomi.fi-viesteissä eri rajapintojen ominaisuuksina. Jatkossa palvelua käyttävän tai käyttöönottavan organisaation ei tarvitse enää vertailla eri rajapintoja ja arvioida, mikä niistä olisi paras organisaation käyttötarpeisiin nähden. Kaikki ominaisuudet löytyvät yhden rajapinnan takaa. 

Digi- ja väestötietovirasto on määritellyt nyt aikataulun, jolla vanhoista liitynnöistä tullaan luopumaan. Uusi REST-rajapinta ei vaikuta vanhoihin rajapintoihin, ne toimivat uuden rajapinnan rinnalla edelleen. Kaikki uudet Suomi.fi-viestien käyttöönotot tehdään kuitenkin jo nyt vain REST-rajapinnan kautta. 

Vanhoista rajapinnoista luovutaan vaiheittain

1.1.2025 alkaen kaikki uudet Suomi.fi-viestien käyttöönotot tehdään REST-rajapintaan. Käytössä oleviin vanhoihin liityntöihin on mahdollista lisätä uusia palveluita 31.12.2025 saakka. Tämä koskee erityisesti palveluita, jotka liitetään Suomi.fi-viesteihin organisaation käyttämän ICT-palvelutuottajan tarjoaman valmisohjelmiston kautta. 

Kaikki vanhat rajapinnat suljetaan 1.1.2027. Tämä tarkoittaa sitä, että kaikkien Suomi.fi-viestejä käyttävien palvelujen pitää siirtyä käyttämään uutta REST-rajapintaa ennen vuotta 2027.

Sujuvampi käyttö uuden rajapinnan kautta

Uusi REST-rajapinta helpottaa Suomi.fi-viestien ominaisuuksien käyttöönottoa organisaatioissa. Lisäksi sen ylläpito on sujuvampaa ja mahdolliset vikatilanteet huomataan ja pystytään korjaamaan nopeammin. 

Siirtymän uuteen rajapintaan voi tehdä myös vaiheittain.

”Jos organisaationne on tekemässä muutoksia Suomi.fi-viestien käyttöön, niin samassa yhteydessä kannattaa siirtyä käyttämään uutta REST-rajapintaa jo nyt. Siirtymän voi tehdä hallitusti yksi palvelu tai toiminnallisuus kerrallaan, jolloin muutostöitä voi palastella pidemmälle aikavälille”, kannustaa Suomi.fi-viestien palveluomistaja Maria Juka-Lahdenperä Digi- ja väestötietovirastosta.

Katso kootut aikataulut siirtymälle vanhoista liitynnöistä REST-rajapintaan:

Jokaisen Suomi.fi-viestejä käyttävän organisaation pitää olla siirtynyt käyttämään uutta REST-rajapintaa.

Lisätietoja
Digi- ja väestötietovirasto, Organisaatioiden asiakaspalvelu, p. 0295 535 115 (puhelinpalvelu avoinna ma-pe klo 9–15), [email protected]