Tekniske opplysninger om Brønnøysundregistrenes Web Services
Etter å ha tegnet avtale og fått tildelt brukernavn og passord fra Brønnøysundregistrene, er det mulig å koble seg opp mot vår Web Services for gjenbruk av grunndata. Brukeren må selv utvikle applikasjonen(e) som skal importere data fra Enhetsregisteret ved hjelp av XML-schemaene under. Brønnøysundregistrene bidrar ikke med teknisk bistand på dette området, men kan gi faglig rådgivning innen bruk av grunndata fra Enhetsregisteret.
Nøkkelen for å gjøre oppslag mot Enhetsregisteret med Web Services er organisasjonsnummer. Dersom man ikke kjenner organisasjonsnummeret til et foretak, kan man finne dette ved å slå opp i tjenesten «Navnesøk».
Resultatet av en spørring mot Enhetsregisterets database returneres til det spørrende systemet etter et fast mønster.
For å kunne koble opp og utvikle applikasjoner mot vår Web Services, trengs Web Services Description Language (WSDL). WSDL er en XML-basert spesifikasjon for å beskrive Web Services. Et WSDL-dokument beskriver hvilke metoder som er tilgjengelig og hvordan man skal koble seg opp mot løsningen.
For å hente ut data med Web Services, gjøres oppkoblingen mot en URL hvor WSDL-filen ligger. Web Services Gjenbruk av Grunndata finner du her:
Enhetsregisteret og Foretaksregisteret: https://ws.brreg.no/grunndata/ErFr?WSDL (kryptert overføring)
Frivillighetsregisteret:
https://ws.brreg.no/grunndata/Frivillighet?WSDL (kryptert overføring)
Det kreves kryptert overføring av data fordi noen av tjenestene inneholder opplysninger om fødselsnummer kombinert med navn.
Tjenester og XML-schema
Grunndataene i Enhetsregisteret er gruppert i ti ulike tjenester. Klikk på tjenestene for å se detaljert datainnhold i de enkelte gruppene. For å kunne programmere applikasjoner mot våre tjenester, må det benyttes XML-schemaer for å vite hvordan dataene er strukturert i XML-strengen som leveres fra oss. Hver av tjenestene har egne XML-schema.
Tilleggstjenester
I tillegg til tjenestene nevnt over har vi flere tilleggstjenester tilgjengelig. Klikk på tjenestene for beskrivelse av funksjonalitet.
Nærmere beskrivelse av Web Services
Web Services-teknologien beskrives på sidene til W3C (World Wide Web Consortium). "Use cases" (brukseksempler) beskrives nærmere i dokumentet "Web Services Architecture Usage Scenarios"
Web Services ordbok
Viktige begreper; W3C har laget en oversikt over Web Services-termer.
|
