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ø.

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.

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.

GET {miljø}/dibk/{app}/applicationMetadata 

Hver tjeneste vil i tillegg ha egen dokumentasjonssidene på confluence - Altinn 3 - Status og tjenester

For mer informasjon, besøk App Metadata-dokumentasjon.

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.

• For mer informasjon om ID-porten, se ID-porten dokumentasjon.

• For veiledning om innveksling til Altinn-token, se innveksling til Altinn-token.

Endepunkter for utveksling av ID-porten-token:

• TT02-miljø (test):
  https://platform.tt02.altinn.no/authentication/api/v1/exchange/id-porten

• Prod-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.

https://app-ftpb-testmotor.azurewebsites.net/logg-inn