Sökgränssnittet för gränssnittsversion 12 i Suomi.fi-servicedatalagret som betaversion i produktionsmiljön, även API-nyckeln tas i bruk

Sökgränssnittet i Suomi.fi-servicedatalagrets nya gränssnittsversion 12, dvs. OUT-gränssnittet, har publicerats som betaversion i produktionsmiljön. I gränssnittet kan man hämta produktionsmiljöns data. 

SDL:s API-dokumentation https://docs.palvelutietovaranto.suomi.fi/api-documentation/v12/Öppnas i ett nytt fönster. 

Anvisningar för användningen av gränssnittsversion 12 finns på webbplatsen Suomi.fi för tjänsteutvecklare på sidan Gränssnitts- och arkitekturreformÖppnas i ett nytt fönster. och dess undersidor. 

Observera att det nu publicerade gränssnittet är en betaversion som kommer att ändras ännu länge. 

Ändringsloggen upprätthålls på finska på sidan V12-hakurajapinnan muutosloki.  

Vid gränssnittssökningar kan det förekomma felet 503 Service unavailable. Detta beror på tillfälliga belastningstoppar som ännu inte har kunnat optimeras i de nya gränssnitten. Skicka feedback till oss på ptv-tuki@dvv.fi om felet uppstår, så att vi kan optimera applikationens funktion. 

Den slutliga versionen publiceras i produktionsmiljön i slutet av 2026, när Myndigheten för digitalisering och befolkningsdata har kunnat försäkra sig om att tillräckligt många organisationer har testat den nya gränssnittsversionen och att det inte längre uppstår betydande utvecklingsbehov. Publiceringstidpunkten för den slutliga produktionsversionen meddelas på hösten.  

Det är inte möjligt att testa IN-gränssnittet i version 12, utan metoderna för IN-gränssnittet publiceras i kundtestmiljön först på hösten. IN-gränssnittet kallas i fortsättningen importgränssnitt. 

API-nyckeln i bruk 

Användning av produktionsmiljön i version 12 förutsätter användning av API-nyckel.  

Hämta API-nyckeln på https://palvelutietovaranto.suomi.fi/self-service.Öppnas i ett nytt fönster. 

Finskspråkiga anvisningar för beställning av en API-nyckel finns på sidan API-avaimen käyttöohje (PTV rajapintaversio 12). 

Gränssnittet för hantering av API-nycklar publiceras nu i en något förenklad version och kommer fortfarande att förändras under april–maj. Till en början kan en organisation i praktiken beställa en API-nyckel endast för en enda integration. Till exempel ett välfärdsområde som har flera SDL-integrationer bör inledningsvis testa betaversionen av gränssnittet 12 endast med en integration. 

Senare i vår blir det möjligt att beställa nycklar för olika integrationer. Vi informerar om detta och om nödvändiga åtgärder vid ett senare tillfälle.  

API-nyckeln tas i bruk även i kundtestmiljön under april, dvs. senare än i produktionsmiljön. 

Vi tar emot kommentarer  

Sökgränssnitten publiceras nu som betaversioner och vi tar emot respons och observationer om testningens resultat, dokumentationen och anvisningarna.  

Du kan kommentera anvisningarna och det nya sökgränssnittet på adressen ptv-tuki@dvv.fi.