Authority: https://login.microsoftonline.com/braarkivb2cprod.onmicrosoft.com
ClientId: kontakt Geomatikk
ClientSecret: kontakt Geomatikk
Scope: https://braarkivb2cprod.onmicrosoft.com/app-api-prod/.default
curl -X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id={ClientId}&scope=https://braarkivb2cprod.onmicrosoft.com/app-api-prod/.default&client_secret={ClientSecret} \
&grant_type=client_credentials" "https://login.microsoftonline.com/braarkivb2cprod.onmicrosoft.com/oauth2/v2.0/token"https://api.geodoc.no/v1/tenants/{Tenant}/records
I {Tenant} legger du inn navnet på tenant/kunde i GeoDoc.
Merk at dette kallet henter også slettede og halvferdige registreringer. For å hente bare aktive registreringer som er ferdig prosessert, legg på følgende filter:
/records?$filter=docState eq 7 and (docStatus eq 1 or docStatus eq 4)
Hent alle registreringer som tilhører arkivdel med id ‘1001’ eller ‘1002’:
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001', '1002') and docState eq 7 and (docStatus eq 1 or docStatus eq 4)
Hent alle registreringer som tilhører arkivdel med id ‘1001’ eller '1002’ og dokumentkategori lik ‘Korrespondanse’ eller 'Søknad' eller 'Tegninger':
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001', '1002') and dokumentkategori in ('Korrespondanse', 'Søknad', 'Tegninger')
Hent alle registreringer som tilhører arkivdel med id ‘1001’ og matrikkel/GID ‘1/2/3/4':
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001') and gid/any(x:x/gardsnummer eq 1 and x/bruksnummer eq 2 and x/festenummer eq 3 and x/seksjonsnummer eq 4)
Hent alle registreringer som tilhører arkivdel med id ‘1001’ og matrikkel/GID ‘1/2':
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001') and gid/any(x:x/gardsnummer eq 1 and x/bruksnummer eq 2)
Hent alle registreringer som tilhører arkivdel med id ‘1001’ og matrikkel/GID ‘1/2' og dokumentkategori lik ‘Korrespondanse’ eller 'Søknad' eller 'Tegninger':
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001') and gid/any(x:x/gardsnummer eq 1 and x/bruksnummer eq 2) and dokumentkategori in ('Korrespondanse', 'Søknad', 'Tegninger')
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001') and gid/any(x:x/gardsnummer eq 1 and x/bruksnummer eq 2) and classified eq true
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001') and gid/any(x:x/gardsnummer eq 1 and x/bruksnummer eq 2) and publicAccessDenied eq true
Hent alle registreringer hvor saksdato er mellom 1/1-2010 og 30/12-2010:
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=saksdato ge 2010-01-01T00:00:00Z and saksdato le 2010-12-30T23:59:59Z
Paginering i GeoDoc API gjøres ved å kombinere $skip og $top.
Hent første 100 registreringer på side 1 som tilhører arkivdel med id ‘1001’:
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001')&$skip=0&$top=100
Hent neste 100 registreringer på side 2 som tilhører arkivdel med id ‘1001’:
https://api.geodoc.no/v1/tenants/{Tenant}/records?$filter=seriesId in ('1001')&$skip=100&$top=100
Hent alle arkivdeler:
https://api.geodoc.no/v1/tenants/{Tenant}/series
Hent metadata lookupverdier for alle arkivdeler:
https://api.geodoc.no/v1/tenants/{Tenant}/metadata-types?$expand=lookupvalues
1. Sett i gang nedlasting av registrering 200000025:
https://api.geodoc.no/v1/tenants/{Tenant}/records/20000025/download
Respons skal da være 202 Accepted, og inneholde containerName og blobName. Dette vil starte en bakgrunnsjobb på Geomatikks servere.
{
"containerName": "1b26be0b-ae02-45e1-8786-5a0294ac4eca",
"blobName": "1_35_0_0_1_78_0_Foto_ID_20000025.pdf"
}
2. Sjekk status på bakgrunnsjobben ved å kalle /download/status med /{containerName}/{blobNavn}:
https://api.geodoc.no/v1/tenants/{Tenant}/records/download/status/1b26be0b-ae02-45e1-8786-5a0294ac4eca/1_35_0_0_1_78_0_Foto_ID_20000025.pdf
Når nedlasting er klar er respons 200 og status “Success”. Inntil det skjer må endepunktet polles. Når status er “Success” vil Uri inneholde lenke til fil.
{
"status": "Success",
"uri": "https://download.blob.core.windows.net/f0bcf4f9-6f89-9354-9daf-beb97fde22cc/1_35_0_0_1_78_0_Foto_ID_20000025.pdf?sv=2023-08-03&st=2023-12-15T11%3A50%3A38Z&se=2023-12-22T11%3A50%3A38Z&sr=b&sp=r&sig=Fdgg3ed2S"
}
3. Kjør GET mot uri. Denne lenken har begrenset levetid, og skal kun brukes ved nedlasting gjennom GeoDoc apiet.
https://download.blob.core.windows.net/f0bcf4f9-6f89-9354-9daf-beb97fde22cc/1_35_0_0_1_78_0_Foto_ID_20000025.pdf?sv=2023-08-03&st=2023-12-15T11%3A50%3A38Z&se=2023-12-22T11%3A50%3A38Z&sr=b&sp=r&sig=Fdgg3ed2S
Opplasting foregår i 3 trinn:
https://api.geodoc.no/v1/tenants/{Tenant}/records/blobupload for å få generert en URL til en Azure Blob container. URLen inneholder et SAS-token som gir skriverettigheter mot den opprette containeren.https://api.geodoc.no/v1/tenants/{Tenant}/records/stage-package POST /v1/tenants/{tenant}/records/stage-package
{
blobContainerUri: "Uri to blob container",
metadata: {
"seriesId": "1001",
"bid": [ 12345 ],
"isittrue": true,
"dokumentkategori": "Avtale",
"gid": [
{
"bruksnummer": 2,
"festenummer": 0,
"gardsnummer": 1,
"seksjonsnummer": 0
}
],
"saksdato": "2022-01-25",
"sakstittel": "My title"
}
}Det vil skje en validering av både fil(er) og metadata som gjør at du kan få en 400 Bad Request. Det returneres en detaljert JSON med årsaken til at man fikk en 400 Bad Request. JSON-strukturen er under endring og vi anbefaler å lese ut hele JSON-strukturen programmatisk og ikke basere seg på detaljer i JSON-strukturen.