Veiledning for utviklere

Velkommen til utviklerveiledningen for Altinn Formidling! Denne delen av dokumentasjonen hjelper deg med å komme i gang med Altinn Formidling og gir innsikt i hvordan du best kan utnytte plattformen. Vær oppmerksom på at dokumentasjonen fortsatt er under arbeid, og noen seksjoner kan være manglende eller bare delvis dokumentert.

• Veiledning for avsender

  Denne utviklerguiden hjelper deg med å komme i gang med å sende filer ved hjelp av Altinn Formidling.

• Veiledning for mottakere

  Denne guiden hjelper deg med å komme i gang med å motta filer ved hjelp av Altinn Formidling.

• Altinn 3 Formidling - Utviklerveiledning for Tjenesteeier

  Hvordan komme i gang med Altinn 3 Formidling Tjenesteeier API-operasjoner, for utviklere

• Altinn 3 Formidling Utviklerguider

  Hvordan komme i gang med å abonnere på hendelser fra Altinn 3 Formidling, for utviklere

Siden Altinn Formidling er åpen kildekode, kan du få tilgang til koden vår i vårt offentlige GitHub-repo og bygge en lokal Docker-instans for å teste mot.

Vi ønsker bidrag til løsningen velkommen.

Se Readme-filen på GitHub for en introduksjon til Altinn 3 Formidling, og hvordan du bygger og kjører den i din utviklermiljø.

Repoet inneholder også en Postman-samling med eksempler.

Swagger for filoverførings-APIet er vert her.

Generell API-operasjon

For å forstå hvordan Formidling-APIet fungerer, inkludert avhengighetene og konfigurasjonsstegene, henvises det til informasjonen nedenfor:

Du må ha utført stegene i Hvordan komme i gang for å sette opp tilgangskravene.

Generell prosess

Generell prosessflyt gjenspeiler den implementerte virkeligheten av filoverføringsprosessen

Alle operasjoner er asynkrone, med mindre annet er angitt. Som sådan bør du implementere hendelsesabonnementer for å optimalisere prosessen din i stedet for å stole på polling for status.

Autentisering

For alle operasjoner må du autentisere deg ved å bruke din Maskinporten-klient og deretter skaffe en Altinn-token fra Altinn-autentisering.

Bruk Altinn-tokenet som en Bearer-token for alle Formidling API-forespørsler sammen med APIM-abonnementsnøkkelen som en header med nøkkelen Ocp-Apim-Subscription-Key.