BDSförfrågan-gränssnittets tekniska realisering
På den här sidan har vi samlat teknisk information om BDSförfrågan-gränssnittet. Mer allmän information finns på sidan för BDSförfrågan-gränssnittet.
BDSförfrågan-gränssnittet är en applikationstjänst (web service) som tar emot och returnerar meddelanden enligt XML (SOAP)-protokollet. Via BDSförfrågan-gränssnittet skickas ett förfrågningsmeddelande till tjänsten från kundorganisationens datasystem, varifrån BDS-uppgifterna som motsvarar förfrågan returneras som svarsmeddelande.
Dataöverföringen mellan BDSförfrågan-gränssnittet och kundsystemet sker via internet med HTTPS/TLS-skydd. För att skydda datakommunikationen ska man använda TLS 1.2 eller ett nyare skyddsprotokoll.
Organisationer förutsätts skapa förbindelsen med hjälp av Suomi.fi-informationsleden som erbjuds av Myndigheten för digitalisering och befolkningsdata.
Mer information om detaljerna kring ibruktagandet av informationsleden finns på webbplatsen Suomi.fi.
BDS-uppgifterna i den produkt som beviljas er organisation (svarsmeddelande) fastställs i samband med ansökningsprocessen för datatillståndet. I svarsmeddelandet får kundorganisationen endast den information om objektet (såsom person, lägenhet, byggnad eller fastighet) som den är berättigad till.
Myndigheten för digitalisering och befolkningsdata har färdiga produkter för olika innehåll för olika ändamål. Om er organisation inte hittar en produkt som lämpar sig för era informationsbehov kan vi skräddarsy en ny produkt. 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 (länk).
I regel överlämnas uppgifter endast med en beteckning som individualiserar sökningsobjektet, såsom personbeteckning, elektronisk kommunikationskod eller byggnadsbeteckning. Uppgifter kan också sökas med andra än individualiserade sökkriterier, om kundorganisationens uppgifter kräver det enligt lagen.
Organisationen ska sköta inloggningen på behörigt sätt. En organisation som fått rätten att göra en applikationsförfrågan är skyldig att spara logguppgifterna i fem (5) år. Organisationen ska i efterhand kunna berätta vem som har gjort förfrågan (på personnivå), vilka uppgifter som har sökts och när förfrågan har gjorts (dd.mm.åååå kl.).
Tillståndshavaren ansvarar också för informationssäkerheten i kundsystemet och för att behandlingen av varje hämtad uppgift är lagenlig och att förfrågningarna är förenliga med villkoren i datatillståndet och de beviljade produkternas användningsändamål.
Observera att det inte är tillåtet att kontrollera om hela kund- eller andra registeruppgifter i det egna informationssystemet är aktuella via BDSförfrågan-gränssnittet. Om ni behöver en sådan här typ av tjänst finns det sannolikt en lämpligare tjänst i befolkningsdatasystemets informationstjänster för den offentliga sektorn eller den privata sektorn.
I dokumentet servicebeskrivning för BDSförfrågan-gränssnittet (länk på kommande) hittar du en närmare beskrivning av tjänsten och kundorganisationens skyldigheter.
Gör så här
Läs mer om drifttagning av BDSförfrågan-gränssnittet på webbplatsen BDSförfrågan.
Drifttagning av BDSförfrågan-gränssnittet via Informationsleden
- Anslut dig till Suomi.fi-serviceadministrationen.
- Anslut dig till Suomi.fi-informationsleden.
- Ansök om användningstillstånd för testleden.
- Välj en lämplig lösning för anslutningsservern.
- Definiera minst ett subsystem för anslutningsservern.
- Testa ledens testmiljö med Informationsledens testtjänster.
- Be att få BDSförfrågan-gränssnittets datatillstånd till Informationsledens testmiljö. Integrera och testa enligt BDSförfrågan-gränssnittets anvisningar.
- Ansök om Informationsledens användningstillstånd för produktion och gå till produktionsmiljön.
OBS! Det lönar sig att samtidigt ansöka om BDSförfrågan-gränssnittets datatillstånd!
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
- Förmyndarskap
- Livsförändringar utomlands
- Flyttning i utlandet
- 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
- Registrering av utlänningar
- Guiden för studerande
- Hemkommun
- Anvisningar till dig som kommer till Finland från Ukraina
- Guiden för arbetstagare
- Expressfil för specialsakkunniga och tillväxtföretagare
- Legaliseringsanvisning
- Inlämnande av utländska dokument
- Utlänningars flytt till Finland, inom Finland och från Finland
- Val och rösträtt
- 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
- Personbeteckning
- Utlämning av uppgifter ur befolkningsdatasystemet
- Spärrmarkering
- Övervakning och loggföring av användningen av informationen i befolkningsdatasystemet
- Fastställande av annan könstillhörighet
- Utträde ur och inträde i ett religionssamfund
- Förbud mot utlämning av personuppgifter
- Ändring av ett registrerat partnerskap till äktenskap
- Utlämning av uppgifter ur 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
- Befolkningsdatatjänster för organisationer
- Den offentliga förvaltningens urvals- och uppdateringstjänst
- Informationstjänster inom den privata sektorn
- BDS-ändringsgränssnittet
- Ändringsdatatjänsten
- BDSförfrågan-gränssnittet
- Webbapplikationen för BDSförfrågan
- BDSförfrågans urvalstjänster
- Revidering av personbeteckningen
- Förutsättningar för att använda befolkningsuppgifter
- Magistratregistrens söktjänster
- Upprätthållande av befolkningsdatasystemet
- Suomi.fi-tjänster
- Tjänster som främjar digitaliseringen
- Digistöd
- 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
- Myndigheten för digitalisering och befolkningsdata
- Jobba med oss
- Kommunicera elektroniskt med oss
- Kontakt
- Aktuellt
- Automatiskt avgörandeförfarande
- Kvalitetspolicy
- Likabehandlingsplan för kunder
- Dataskydd
- Befolkningsdatasystemet
- Till medier
- Broschyrer och publikationer
- Projekten
- Förutseende och forskningssamarbete