Suomi.fi kehittäjille
Siirry suoraan sisältöön.

SMTP-rajapinta

Huomaattehan, että Suomi.fi-viestien vanhat rajapinnat ovat ylläpitotilassa, eikä niihin lähtökohtaisesti enää tuoteta uusia toiminnallisuuksia. 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.

SMTP-rajapinta on Suomi.fi-viestien vanhoista rajapinnoista kevyin ja yleensä edullisin käyttöönottaa. SMTP tukee viestien kaksisuuntaisuutta, mutta sen kautta voi lähettää ainoastaan sähköisiä viestejä.

Rajapintaa käytettäessä viestit lähetetään suoraan organisaationne sähköpostipalvelusta. Lähettävänä sähköpostiosoitteena voi olla yksittäisen organisaationne edustajan osoite, anonyymi palveluosoite tai koko organisaationne sähköpostin domain-osoite. Loppukäyttäjältä tulevat vastausviestit voidaan määritellä saapumaan myös muuhun kuin alkuperäiseen lähetysosoitteeseen.

Organisaationne sähköpostin domain liitetään Suomi.fi-viesteihin Valtorin Yhteisen integraatioalustan (VIA) kautta. Tärkein toimenpide liittämisessä on VY-verkon IRHS-palvelimen ja VyVI-palveluun kuulumattoman organisaation sähköpostipalvelimen välille toteutettava pakotettu TLS-salaus (Secure SMTP over TLS).

SMTP-rajapinnan käyttötapauksien ohjeet

SMTP-rajapintaa voi käyttää sekä viestien lähettämiseen loppukäyttäjälle että loppukäyttäjien lähettämien viestien vastaanottamiseen. Alla oleviin osioihin on koottu ohjeet siitä, miten käyttötapaukset toimivat käytännössä. 


Päivitetty: 17.3.2025

Oletko tyytyväinen tämän sivun sisältöön?