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.
Suomi.fi-viestien ensisijaiset rajapinnat ovat REST ja POST, mutta näiden lisäksi Suomi.fi-viestit tukee kolmea muuta rajapintaa, joiden kautta palvelun toiminnallisuuksia aikaisemmin pääsääntöisesti tarjottiin. Näihin Suomi.fi-viestien ns. vanhoihin rajapintoihin lukeutuvat WS, SFTP ja SMTP.
Vanhoja rajapintoja käytettäessä liityntä Suomi.fi-viesteihin tehdään aina Valtion tieto- ja viestintätekniikkakeskus Valtorin Yhteisen integraatioalustan (VIA) kautta. Tämä poikkeaa REST-rajapinnasta, jossa Suomi.fi-viesteihin kytkeydytään suoraliitynnällä.
Web Service (WS) on Suomi.fi-viestien vanhoista rajapinnoista monipuolisin. Rajapinta tukee sekä viestien kaksisuuntaisuutta että paperipostiin ohjaamista.
WS-rajapinnassa liityntä tehdään SOAP-palveluna HTTPS-siirtoprotokollan yli. Rajapinta jakautuu pakolliseen Viranomaispalvelut-rajapintaan ja vapaaehtoiseen Paluukanava-rajapintaan ja niiden sisältämiin operaatioihin.
Lukekaa lisää tästä rajapinnasta WS-rajapinta-sivulla.
SFTP-rajapinta erikoistuu usean viestin lähettämiseen kerralla yhdessä lähetyserässä. Lähettämiseen käytetään iPost-muotoa ja se tukee sekä sähköisten että paperipostiin ohjautuvien viestien välittämistä. Jos sähköisiin viesteihin halutaan vastausmahdollisuus tai niiden tiloja halutaan seurata, täytyy organisaationne ottaa SFTP-rajapinnan lisäksi käyttöön toinen toiminnallisuuksia tukeva rajapinta.
Käyttäessänne rajapintaa viestiaineisto siirretään SFTP-tiedonsiirtoprotokollalla isona tiedostona organisaationne palvelimelta Suomi.fi-viesteihin, jossa se puretaan sähköisenä ja paperipostina lähetettäviin viesteihin.
Lukekaa lisää tästä rajapinnasta SFTP-rajapinta-sivulla.
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.
Lukekaa lisää tästä rajapinnasta SMTP-rajapinta-sivulla.
