Nyttig informasjon for utviklere

I denne artikkelen finner du informasjon om tilgang til sikre Geodata Online-tjenester, uthenting av sikkerhets-token, og lenker til dokumentasjon av REST-API.

Tilgang til sikre tjenester

Tjenestene fra Geodata Online er sikret. For å benytte tjenestene i en applikasjon eller web-løsning må du generere en token, enten manuelt eller programmatisk via ArcGIS Server REST API.

Du må registrere deg som bruker av Geodata Online og ha gyldig brukernavn og passord er for å kunne generere en gyldig token. Hver token er kun gyldig i en tidsperiode som du selv bestemmer, oppad begrenset til 365 dager.

Token brukes for å autentisere og autorisere alle HTTP kall mot Geodata Online. En token er gyldig enten for en IP-adresse eller en HTTP-referer.

  • IP adresse. Du kan enten angi IP adresse når du genererer en token, eller be Geodata Online lage en token for den IP adressen du gjør forespørselen fra.
  • HTTP-referer er URLen til nettsiden der trafikken innledes fra.

Lage token manuelt:

På denne siden kan du skrive inn brukernavn og passord, pluss en del andre innstillinger, og lage et nytt token.

Du kan også programmatisk generere token ved bruk av REST API-kallet generateToken:

https://services.geodataonline.no/arcgis/tokens/generateToken?username=&password=&client=&expiration=

  • client=requestip genererer en token for IP adressen der kallet sendes fra.
  • Hvis man bruker client=ip må parameteren &ip= legges til.
  • Hvis man bruker client=referer må parameteren &referer= legges til.
  • For parametrene <brukernavn> og <passord> setter du inn dine personlige verdier.

URL encoding

Alle parametere som sendes inn til token generatoren bør URL encodes. URL encodeing er spesielt viktig fordi passord for tilgang til Geodata Online må inneholde spesialtegn.

NB! Er ditt passord f.eks sdWEgŤ#, må passordet angis som sdWEg%C3%85%C2%A4%23

Dokumentasjon av "generateToken"-tjenesten finnes her.

Dokumentasjon av REST-API

Alt av tjenester fra Geodata Online er tilgjenglig via REST/JSON, og over http og https. Vi anbefaler på det sterkeste å bruke https.

Adressen til Geodata Online er:
https://services.geodataonline.no/arcgis/rest

REST-endepunktene over har også en enkel web/html-visning. Logger du deg inn ser du hvilke tjenester du har tilgang til og kan navigere deg rundt. Det er mulig å teste ut alt av funksjoner på tjenester via dette webgrensesnittet. Dette er en effektiv måte å se meta-data og teste ut kall og responser.

Alt av dokumentasjon for REST-api'et for de ulike tjeneste-typene finnes på denne lenken.