Teknisk dokumentation för den som genomför integrationen
SDL genomgår för närvarande en arkitekturreform, som kommer att omfatta lanseringen av gränssnittsversion 12 och, efter en övergångsperiod, en utfasning av gränssnittsversion 11. Vänligen ta hänsyn till denna förändring när du planerar din nya integration!
Gränssnitts- och arkitekturreformÖppnas i ett nytt fönster.
Servicedatalagrets gränssnittsversioner
För närvarande används SDL:s gränssnittsversion 11. Det kommer inte längre att göras några nya integrationer med gränssnittsversion 11.
API-version | 2025 | 2026 | 2027 |
|---|---|---|---|
API version 11 | stöds | stöds | gränssnittet ska tas ur drift våren 2027 (preliminärt) |
API version 12 | Metoderna för OUT-gränssnittets produktionsmiljö (betaversion) införs | IN-gränssnittsmetoder ska implementeras våren 2027 (preliminärt) |
Ändringar görs mycket sällan i SDL:s gränssnitt.
Basuppgifter om SDL:s gränssnitt
Servicedatalagret har ett öppet REST/JSON-gränssnitt. Uppgifterna ges fritt för vidare användning med CC0-licens, dvs. uppgifterna kan användas fritt. Myndigheten för digitalisering och befolkningsdata förutsätter dock att varje organisation som genomför en integration meddelar om integrationen och skickar kontaktuppgifter för störningskommunikation till ptv-tuki@dvv.fi.
OUT-gränssnittet gör det möjligt att söka uppgifter utan inloggning eller användningstillstånd.
Mer information för den som genomför OUT-integrationen
Via IN-gränssnittet är det möjligt att importera information från ett annat system till SDL. Detta förutsätter dock ett separat användningstillstånd.
Mer information för den som genomför IN-integrationen
Kartkoordinatstandarden som används i organisationens och serviceställets lokaliseringsuppgifter är EPSG 3067.
När en ny integration genomförs ska den nyaste gränssnittsversionen alltid tas i bruk.
Datamodell
Servicedatalagret innehåller kundorienterade uppgifter om tjänsterna och tillhörande servicekanaler samt kopplingsuppgifter mellan dessa. Dessutom kan man hämta uppgifter om de organisationer som beskrivit tjänsterna. Innan du börjar genomföra integrationen ska du noggrant bekanta dig med SDL:s koncept och datamodell.
En del av uppgifterna i Servicedatalagret är beskrivningar i textform avsedda för läsare som är människor, en del är metadata.
SDL:s produktions-Swagger
Metoderna för OUT- och IN-gränssnitten finns i SwaggerÖppnas i ett nytt fönster.. Metoderna är indelade i åtta olika ämnesområden:
- CodeList/Kodsystem
- Common/Allmänna
- Connection/Koppling
- GeneralDescription/Basbeskrivning
- Organization/Organisation
- Service/Tjänst
- ServiceChannel/Servicekanal
- och ServiceCollection/Servicehelhet)
GET-metoderna gör det möjligt att söka uppgifter, POST-metoderna möjliggör tilläggande av nya uppgifter och PUT-metoderna uppdaterar dessa uppgifter. Användningen av POST- och PUT-metoderna förutsätter användningstillstånd för IN-gränssnittet.
Uppgifterna om tjänsterna kan också sökas utifrån områdesuppgifter, målgrupp, servicegrupp, tjänstetyp och näringsgrensklass.
Närmare anvisningar om användningen av metoderna finns i Swagger.
En del av metoderna är begränsade till MDB:s eget bruk och en del till användningen av ASTI-systemet.
SDL:s källkod
SDL:s källkod är för närvarande inte tillgänglig i Github. Om SDL:s kod behövs, be om den på adressen ptv-tuki@dvv.fi.