Er organisation kan använda flera olika gränssnitt för att utnyttja Suomi.fi-meddelanden.
I regel rekommenderar vi att er organisation använder REST-gränssnittet för Suomi.fi-meddelanden. Dessutom kan ni använda POST-gränssnittet för att förmedla de blanketter som slutanvändarna fyllt i i er e-tjänst till Suomi.fi-meddelanden. Övriga gränssnitt är i underhållsläge och användningen av dem rekommenderas i regel inte längre. Dessa omfattar WS-, SFTP- och SMTP-gränssnitten.
Om er organisation använder REST- eller POST-gränssnittet ansluter ni er till Suomi.fi-meddelanden via direktanslutning. Vid användning av andra gränssnitt ska er organisation göra anslutningen via Statens center för informations- och kommunikationsteknik Valtoris gemensamma integrationsplattform (VIA).
Ni kan bekanta er med gränssnitten i allmänhet på den här sidan och närmare på de separata undersidorna till gränssnitten. Ni kan dessutom jämföra gränssnitten med hjälp av Egenskapsförteckningen för gränssnitten.
REST är det nyaste och mest mångsidiga gränssnittet för Suomi.fi-meddelanden. Alla funktioner som beskrivs i avsnittet Funktioner kan användas i REST-gränssnittet.
Informationsförmedlingen i REST-gränssnittet grundar sig på en enkelriktad integration där er organisation anropar Suomi.fi-meddelanden oberoende av vilken funktion som används.
POST-gränssnittet gör det möjligt att förmedla och lagra uppgifter i de blanketter som slutanvändarna fyllt i i er e-tjänst i Suomi.fi-meddelanden.
POST-gränssnittet används endast för att överföra blankettens uppgifter från er e-tjänst till Suomi.fi-meddelanden. Överföringen av uppgifter grundar sig på POST-anrop. För att ta emot blankettinnehållet från Suomi.fi-meddelanden måste er organisation utöver POST-gränssnittet ta i bruk ett annat gränssnitt som stöder svarsmöjligheten.
Utöver de ovan nämnda huvudsakliga gränssnitten är det möjligt att använda Suomi.fi-meddelanden via tjänstens äldre gränssnitt (WS, SFTP och SMTP). Observera dock att dessa gränssnitt är i underhållsläge och att man i regel inte längre producerar nya funktioner för dem. Alla gamla gränssnitt stängs den 1 januari 2027. Detta innebär att alla tjänster som använder Suomi.fi-meddelanden måste övergå till att använda det nya REST-gränssnittet före år 2027.
