Gränssnittets tekniska realisering och användningen av tjänsten
BDS-förfrågningsgränssnittet är en applikationstjänst (web service) som tar emot och returnerar meddelanden enligt XML (SOAP)-protokollet. Kundorganisationens datasystem inleder sökningen av BDS-uppgifter genom att skicka ett förfrågningsmeddelande till tjänsten och får som svar de sökta BDS-uppgifterna i svarsmeddelandet.
Bildandet av en förbindelse
Förfrågningsförbindelserna mellan kundsystemet och befolkningsdatasystemet identifieras och skyddas i regel med hjälp av servercertifikat. Dataöverföringen mellan gränssnittet och kundsystemet sker via internet med HTTPS/TLS-skydd. Rekommendationen för datakommunikationens skydd är protokollet TLS 1.2.
Den offentliga förvaltningens organisationer förutsätts skapa förbindelsen med hjälp av Den nationella informationsleden som erbjuds av Myndigheten för digitalisering och befolkningsdata. Skyldigheten finns inskriven i lagen om förvaltningens gemensamma stödtjänster för e-tjänster. För andra organisationer är det valfritt att använda informationsleden som förbindelsemetod. Mer information om detaljerna kring ibruktagandet av informationsleden finns på informationsledens sida.
Gränssnittsmeddelandenas form och innehåll
Via BDS-förfrågningsgränssnittet är det möjligt att söka all information i befolkningsdatasystemet och den kan vid behov skräddarsys till nya kombinerade uppgifter. En förteckning över de personuppgifter och deras format som i dagsläget kan hämtas med gränssnittet finns i personuppgiftskatalogen på den här sidan (i XML Schema-format).
En generell beskrivning av gränssnittets tekniska funktioner såsom olika typer av sök- och svarsmeddelanden finns i dokumentet om applikationsgränssnittets tekniska beskrivning ( i WSDL-format) som kan laddas ner på den här sidan.
Exakt format på det svarsmeddelande som beviljas er organisation och de BDS-uppgifter som meddelandet innehåller fastställs i samband med den ansökning av datatillstånd som krävs. I svarsmeddelandet får kundorganisationen endast den information om objektet (såsom person, lägenhet, byggnad eller fastighet) som den är berättigad till. I regel överlämnas uppgifter endast med en beteckning som individualiserar sökningsobjektet, såsom personbeteckning, elektronisk kommunikationskod eller byggnadsbeteckning. Om kundorganisationens uppgifter enligt lag förutsätter så kan uppgifterna även sökas med andra än individualiserande sökkriterier.
Om kundsystemets skyldigheter
Användarrätten till BDS-förfrågningsgränssnittet beviljas för organisationen. Tillståndshavaren ansvarar för att man i efterhand på personnivå kan reda ut vem som fått se de uppgifter som sökts från befolkningsdatasystemet via kundsystemet. Den organisation som beviljats rättigheten till applikationsförfrågan är skyldig att spara logguppgifterna för fem (5) år.
Tillståndshavaren ansvarar även för kundsystemets datasäkerhet och för att varje uppgift som sökts behandlas enligt lag och på ett ändamålsenligt sätt. Det är inte tillåtet att granska att det egna datasystemets hela kund- eller övriga register är uppdaterat med hjälp av BDS-förfrågningsgränssnittet utan undantagstillstånd från Myndigheten för digitalisering och befolkningsdata. Om ni har ett sådant här behov hittar ni antagligen en mer lämplig tjänst i övriga BDS-datatjänster.
I dokumentet BDS-förfrågningsgränssnittets servicebeskrivning på den här sidan hittar du en närmare beskrivning av tjänsten och kundorganisationens skyldigheter.
Länkar till lagar som berör ärendet
Statsrådets förordning om befolkningsdatasystemet (128/2010)
Lag om förvaltningens gemensamma stödtjänster för e-tjänster (571/2016)
Dataskyddslag (1050/2018)
Länkar som beror ärendet
- VTJ-kyselyrajapinta, henkilötietokatalogi (endast på finska)
- Sovellusrajapinnan tekninen kuvaus (WSDL) (endast på finska)
- Mer information om Suomi.fi-informationsled
- Privatpersoner
- Handläggningstiderna vid kundtjänsten för privatpersoner
- Äktenskap och parförhållande
- Att få eller adoptera barn
- Namnärenden
- Flytt
- Livsförändringar utomlands
- Registrering i Finland av ett barn som fötts utomlands
- Äktenskap som ingåtts utomlands
- Partnerskap som registrerats utomlands
- Skilsmässa som beviljats utomlands
- Namn som ändrats utomlands
- Könstillhörighet som fastställts utomlands
- Dödsfall utomlands
- Registrering av medborgarskap
- Bevarande av finskt medborgarskap
- Legalisering av utländska handlingar
- Inlämnande av utländska dokument till Myndigheten för digitalisering och befolkningsdata
- Utlänning i Finland
- Val och rösträtt
- Förmyndarskap
- Intressebevakningsfullmakt
- Enklare alternativ till intressebevakning
- Förordnande av intressebevakare
- Intressebevakarens person och uppgifter
- Intressebevakning för en minderårig
- Vem kan vara intressebevakare?
- Rättshandlingar som kräver tillstånd
- Förordnade av ställföreträdande intressebevakare
- Intressebevakningens upphörande
- Att avstå från uppdraget som intressebevakare
- Bevakning av en frånvarande persons eller en blivande egendomsägares intressen
- Övervakning av intressebevakarens verksamhet
- Begränsning av handlingsbehörigheten och omyndigförklaring
- Utdrag registret över förmynderskapsärenden
- Information till bl.a. läkare, myndigheter och andra instanser
- Suomi.fi-webbtjänst
- Medborgarcertifikat och elektronisk identitet
- Registrering av anmälan om gåva
- Intyg från befolkningsdatasystemet
- Kontroll av egna uppgifter -service
- Medborgarinitiativ
- Personuppgifter i befolkningsdatasystemet
- Byggnads- och lägenhetsuppgifter i befolkningsdatasystemet
- Adresstjänst
- Medborgarrådgivning
- Tjänster av notarius publicus
- Bestyrkande av köp
- Dödsfall och bouppteckning
- Digitalt stöd för medborgare
- Blanketter
- Organisationer
- Certifikat och kort
- Uppdatering av kundregister
- Urvalstjänster
- Befolkningsdatasystemets söktjänster
- Magistratregistrens söktjänster
- Registerutdrag
- Upprätthållande av befolkningsdatasystemet
- Suomi.fi-tjänster
- Tjänster som främjar digitaliseringen
- Digistöd
- Förnyelse av den digitala identiteten
- Tjänster för digital säkerhet
- Tjänster av notarius publicus
- Bestyrkande av köp
- Vigselrätt
- E-tjänster
- Finnish Authenticator -identifieringstjänsten
- Anvisningar för välfärdsområdena
- Om myndigheten