APIet gir tilgang til en tjeneste som lar deg bestille og motta tinglyste dokumenter og bekreftede grunnboksutskrifter digitalt. For å bruke APIet, må organisasjonen din være registrert hos Digdir og ha blitt lagt til i APIet via Kartverket.
- Prodmiljø: https://dokumentbestilling.kartverket.no/
- Testmiljø: https://dokumentbestilling-test.kartverket.no/
For å bruke APIet, må du først registrere organisasjonen din hos Digdir og hente et maskinporten-token som kreves for å autentisere API-kallene dine.
For å registrere organisasjonen din hos Digdir, opprett en brukerkonto og følg instruksjonene på Digdir sin nettside. Dette krever at du har en gyldig norsk virksomhet med et organisasjonsnummer.
APIet bruker Maskinporten for autentisering. Følg Digdir sine instrukser for å få utstedt et token. Instruksjoner finner du på dokumentasjon for API-konsument hos Digdir.
APIet lar deg bestille tinglyste dokumenter ved å sende en forespørsel til APIet. Forespørselen må inneholde informasjon om hvilket dokument du ønsker å motta. Når du mottar en gyldig respons fra APIet, inneholder den en lenke til dokumentet som du kan laste ned.
Swagger-dokumentasjonen for APIet gir deg en detaljert oversikt over alle API-kallene og tilhørende parameter-informasjon. Åpne Swagger-dokumentasjonen i en nettleser for å bruke Swagger. Velg deretter ønsket API-kall, legg inn nødvendige parametere og send forespørselen. APIet behandler forespørselen og returnerer responsen tilbake til deg.
APIet har følgende begrensninger:
- Kun tilgjengelig for kunder som er registrert hos Digdir og har organisasjonen sin lagt til i APIet.
- Krever et gyldig maskinporten-token som har begrenset varighet og må fornyes regelmessig for å opprettholde tilgangen til APIet.
- Gir tilgang til alle tinglyste dokumenter som er tilgjengelige digitalt og bekreftede grunnboksutskrifter.
APIet vil returnere ulike feilkoder og feilmeldinger avhengig av typen feil som oppstår. Disse er beskrevet i Swagger-dokumentasjonen.