Dibk tilbyr innsendingstjenester for byggesak utviklet som Altinn3-applikasjoner. Applikasjonene har et API-grensesnitt, levert av Altinn, og gir applikasjonsbrukere tilgang til å integrere seg med Altinn3-tjenestene. Den tekniske dokumentasjonen for API'et finnes på Altinn3 API-dokumentasjon.
Miljø
For Altinn-applikasjoner er det tilgjengelig både et testmiljø (TT02) og et produksjonsmiljø.
Miljø - angitt som {miljø} i videre tekst | Basis url |
|---|---|
Test (TT02) | |
Produksjon |
Url til tjenester
{miljø}/dibk/{app}/swagger
App - Navn på tjenesten. Oversikt over navnene på de ulike tjenestene finner du på dokumentasjonssidene for de aktuelle tjenestene.{miljø}/dibk/{app}/swagger
Eksempel: ig-v3
https://dibk.apps.tt02.altinn.no/dibk/ig-v3/swagger/
Informasjon om tjenesten
Altinn App API gir tilgang til metadata-informasjon for applikasjonen. Her kan du finne detaljer om hvordan appen er konfigurert, samt aktuelle datatyper som brukes i tjenesten.
| Kodeblokk |
|---|
GET {miljø}/dibk/{app}/applicationMetadata |
Hver tjeneste vil i tillegg ha egen dokumentasjonssidene på confluence .- Altinn 3 Tjenester
For mer informasjon, besøk App Metadata-dokumentasjon.https://docs.altinn.studio/nb/api/apps/metadata/#get-app-metadata
Autentisering
https://docs.altinn.studio/nb/api/authentication/
For både test- og produksjonsmiljø må ID-porten benyttes for autentisering av sluttbruker. ID-porten-token veksles deretter inn i et Altinn-token.
...
TT02-miljø (test):
https://platform.tt02.altinn.no/authentication/api/v1/exchange/id-portenProd-miljø (produksjon):
https://platform.altinn.no/authentication/api/v1/exchange/id-porten
Testmotor
Bruk testmotor for å teste ut og bli kjent med de ulike tjenestene for innsending.