Gränssnitts- och arkitekturreform

Myndigheten för digitalisering och befolkningsdata håller på att förnya arkitekturen för SDL. Reformen förtydligar och förenklar det tekniska genomförandet av SDL och gör gränssnitten lättare att utnyttja. Dessutom genomför vi flera av de utvecklingsförslag som vi fått av kunderna under årens lopp.

Reformen ändrar inte SDL-datamodellen (med undantag av några tilläggsfält).

Alla organisationer som utnyttjar SDL-uppgifter via OUT-gränssnittet eller importerar uppgifter till SDL via IN-gränssnittet ska övergå till att använda den blivande gränssnittsversionen 12 senast våren 2027. Detta kräver åtgärder från alla integrationskunder.

Tidtabell

01/2026

• OUT-gränssnittsmetoderna för det nya gränssnittet (version 12) har publicerats i kundtestmiljön (utbildningsmiljön) och kan testas.
• Den aktuella datan i kundtestmiljön är tillgänglig, och det går att skapa mer innehåll i befintliga organisationer.
• Från gränssnitten kan alla olika innehållstyper hämtas, till exempel är det möjligt att skapa kombinationer av tjänster och servicekanaler.
• OUT- och IN-gränssnitten i version 11 är fortfarande tillgängliga.

03–04/2026

• Version 12:s nya OUT-gränssnittsmetoder har publicerats som beta i produktionsmiljön. Även efter detta kan det fortfarande ske ändringar i produktionen före hösten 2026.
• OUT- och IN-gränssnitten i version 11 är fortfarande tillgängliga

Hösten 2026 / Preciseras ännu

• IN-gränssnittsmetoderna för det nya gränssnittet (version 12) publiceras i kundtestmiljön och kan testas.
• OUT- och IN-gränssnitten i version 11 är fortfarande tillgängliga

Hösten 2026 / Preciseras ännu

• De slutgiltiga versionerna av version 12:s OUT-gränssnittsmetoder publiceras i produktionsmiljön, och inga brytande ändringar kommer längre att göras.
• Alla olika innehållstyper kan hämtas, API-key tas i bruk.
• OUT- och IN-gränssnitten i version 11 är fortfarande tillgängliga.

Våren 2027 / Preciseras ännu

• IN-gränssnittsmetoderna för det nya gränssnittet publiceras i produktionsmiljön. Alla användare av IN-gränssnittet övergår samtidigt som användare av version 12.
• Gränssnitten i V11 (OUT och IN) tas helt ur bruk.
• Användargränssnittet övergår till att använda den nya applikationens ui-gränssnitt.

Vi informerar våren 2026, alltså ett år i förväg, om när version 11 tas ur bruk.

Vi preciserar tidtabellen för arbetets framskridande på denna sida.

Den nya gränssnittsversionens egenskaper

Vi genomför preliminärt följande egenskaper i det nya gränssnittet (version 12):

• APIkey och kravet på att ge kontaktuppgifter implementeras i OUT-gränssnittet (detta underlättar störningskommunikationen och hanteringen av kundrelationer samt effektiviserar riskhanteringen).
• Vi säkerställer att gränssnittet och schemat samt den övriga gränssnittsdokumentationen i fortsättningen motsvarar varandra och att ändringarna är samordnade.
• OUT- och IN-gränssnittens funktioner och felmeddelanden motsvarar i fortsättningen varandra och felmeddelandena genomförs i ett mer förståeligt format.
• Gränssnittsmetoderna förenklas för att förbättra prestandan och underhållet av SDL. Nu är det till exempel med vissa metoder möjligt att samtidigt hämta uppgifter om både tjänsten och de servicekanaler och kopplingar som anslutits till dem. I fortsättningen kan man hämta var och en av dessa uppgifter från ett eget gränssnitt. På motsvarande sätt skapas, uppdateras och publiceras tjänsten i fortsättningen med egna separata gränssnitt till skillnad från idag.
• I det nya gränssnittet returneras uppgifter i olika språkversioner i en egen samling, inte som i nuvarande modell med en post per språkversion.
• Det blir möjligt att ordna tjänster och servicekanaler i användargränssnittet och gränssnittet.
• Datumformatet för gränssnittet ändras till standardformat. Standarden ISO 8601 tas i bruk.
• Genomförandet av mellanrubrikerna och listorna förnyas i enlighet med de nuvarande standarderna.
• Det blir obligatoriskt att skriva namn i namnfälten för webbadresser och e-postadresser om webbadressen har angetts för att länkarna ska visas tillgängliga för mottagaren. I vissa fall har detta hittills inte varit obligatoriskt.
• Ett fritextfält för att ange tilläggsuppgifter om öppettiden, t.ex. ”stängt under sommaren” läggs till (500 tecken, ”Tilläggsuppgift” + anvisningstext + tooltip).