Gå direkt till innehållet.
Suomi.fi-servicedatalager

Övergång från gränssnittsversion V11 till version V12 (sökgränssnitt)

Beta – innehållet utvecklas

Denna anvisning har utarbetats för organisationer som använder SDL:s sökgränssnitt (OUT-gränssnitt), som utnyttjar SDL-uppgifter via det nuvarande OUT-gränssnittet och som förbereder sig på att övergå från gränssnittsversion 11 till version 12. Anvisningen stöder bedömningen av arbetsmängden och genomförandet av ibruktagandet av den nya versionen. För kunder som använder importgränssnittet (IN-gränssnittet) utarbetas senare en separat anvisning som stöder versionsbytet.

Anvisningen är preliminär och dess innehåll kompletteras och uppdateras under våren 2026 i takt med att arbetet med att reformera SDL:s arkitektur framskrider. Anteckningen ”kommer senare” betyder att anvisningen kompletteras under våren 2026 inom ramen för SDL:s arkitekturreform.

Vad kommer att förändras jämfört med föregående version?

Detta versionsbyte avviker från tidigare i fråga om dess omfattning: ändringarna är betydande och kräver mer beredning och utvecklingsarbete av dem som genomför integrationen.

Hur gränssnittsändringen påverkar användarna

Nödvändiga åtgärder

  • Användningen av gränssnittsversion 12 förutsätter aktivering av en API-nyckel. Se anvisningen [om aktivering av API-nyckeln] (kommer senare). 
  • Användaren av gränssnittet ska uppdatera logiken i gränssnittsanropen och behandlingen av information så att de motsvarar den nya versionens struktur och svarsstrukturer. 
  • Nya gränssnittsanrop och svarsstrukturer ska testas noggrant. Testningen kan göras i kundtestmiljön. Se anvisningen [om testning av gränssnittet] (kommer senare).
  • Bekanta dig med den nya gränssnittsbeskrivningen (SDL API Specification) i kundtestmiljön (utbildningsmiljön)Öppnas i ett nytt fönster. samt sammanställningen av gränssnittsändringarna nedan.

Att beakta under övergångsperioden

  • Observera att två versioner av SDL:s datainnehåll fungerar parallellt i bakgrunden under övergångsperioden – det vill säga under den tid då gränssnittsversionen 11 fortfarande kan användas för att uppdatera uppgifterna i SDL: version 11 och version 12. 
    Inmatningen och uppdateringen av uppgifterna görs fortfarande via version 11, varifrån uppgifterna överförs i bakgrunden till version 12 med en fördröjning på cirka 1–1,5 timmar. 
  • Den första gränssnittsversionen som publiceras i mars 2026 är en betaversion som kan ändras och preciseras före den slutliga versionen. 
  • När SDL:s importgränssnitt för uppgifter tas i testbruk hösten 2026 strävar man efter att befästa innehållet i sökgränssnitten. Målet är att inga betydande ändringar ska göras i dem. 

Ändringar i sökgränssnitten

Det finns två olika söksätt i gränssnittsversion 12 

  • sökning av ett enskilt innehåll med identifikatorer 
  • sökning av uppgifter med sökvillkor, varvid man använder /Search-metoden och dess sökparametrar.  

Search-metoden erbjuder mångsidiga sökfilter som kan användas för att söka information från olika synvinklar i gränssnittet. Sökningen kan avgränsas bland annat utifrån organisation, organisationstyp, servicegrupp, ämnesord, målgrupp och områdesuppgifter.

Innehåll som sökgränssnittet returnerar

  • För uppgifter som kompletterar eller klassificerar det sökta innehållet, såsom tjänstens målgrupper, livssituationer eller ämnesord, returneras endast koder (ID), inte hela innehållet
  • Sökgränssnittet returnerar endast publicerade uppgifter. Arkiverat innehåll (servicekanal, organisation, tjänst) kan sökas med separata anrop. Dessa anrop returnerar endast identifikatorer (ID:n), inte hela innehållet. 
  • Information på olika språk med samma innehåll returneras i en egen samling i languageVersions-strukturen. I exemplet nedan visas en del av de fält i tjänsten som finns på olika språk. Exemplet innehåller inte alla uppgifter som gränssnittet returnerar. 
"languageVersions": {
        "fi": {
          "name":"Osallistuva budjetointi",
          "alternativeName": "Osbu",
          "summary": "Tee ehdotuksia ja äänestä – ole mukana kunnan päätöksenteossa koskien taloutta ja resursseja.",
          "description": "Mitä palvelua tai asiaa kaipaat porvoolaisten iloksi ja hyödyksi? Ehdota ideaa ja äänestä suosikkiasi Porvoon kaupungin toteutettavaksi.",         
         },
        "sv": {
          "name": "Deltagande budgetering",
          "alternativeName": "Osbu",
          "summary": "Lämna förslag och rösta – delta i stadens beslutsfattande om ekonomi och resurser.",
          "description": "Vilken tjänst eller sak längtar du efter som kan vara till glädje och nytta för invånare i Borgå? Föreslå en idé och rösta din favorit att förverkligas i Borgå stad.",
          },
          ...


Följande noggrannare sammanställning av ändringarna i sökgränssnitten har gjorts i jämförelse med det nuvarande gränssnittsversion 11Öppnas i ett nytt fönster..

Ändringar i sökgränssnitten per informationshelhet

Uppdaterad: 24.3.2026

Mer om ämnet

Centrala förbättringar och förändringar

Är du nöjd med innehållet på denna sida?