Apps: Forenklet integrasjon for sluttbrukersystemer

Overordnet beskrivelse

Dagens api endepunkter i en Altinn 3 applikasjon er like på tvers av alle applikasjoner. Dette innebærer at modellene ikke eksponeres siden disse varierer per applikasjon. Man eksponerer i praksis en blob med data og må kommunisere format (XSD eller Json Schema) på andre måter. Api endepunktene er knyttet til den definerte prosessen i applikasjonen og fungerer i praksis på den måten at man oppretter en instans, legger til data, validerer og fullfører prosessen. Dette kan gjøres med minimum to api kall i dag, men er litt avhengig av definerte prosessen. I tillegg kommer evt. feilhåndtering og opprydding av instanser og data hvis man av en eller annen grunn ikke klarer å sende inn skjema. Før et slutbbrukersystem kan benytte apiene må man autentisere seg via Maskinporten samt veksle inn token man får der til et Altinn token.

Dokumentasjon for innsending av data fra sluttbrukersystem

Forventet resultat

Det er identifisert behov for forenklinger knyttet til innsending fra sluttbrukersystemer:

Unngå innveksling til Altinn token
Kunne eksponere modellene på api endepunktene
Kunne sende inn alle nødvendige data med ett kall, og kun hvis validering lykkes, så blir det opprettet data i Altinn. Evt. feil returneres som en liste og må korrigeres før ny innsending kan foretas
Foreta en rettighetssjekk for innlogget bruker for f. eks. å kunne enable/disable funksjonalitet i sluttbrukersystemet.
Kunne støtte en info side til sluttbruker uten komponenter med datamodell bindinger for å informere om at dette er en tjeneste som ikke kan/skal benyttes med frontend.
Kunne benytte systembruker mot app api'ene
Egen swagger for sluttbrukersystem endepunkter - hvilke api endepunkter gjelder for vår frontend?

Hvordan vil det virke?

Gjennomføring

### Oppgaver
- [ ] https://github.com/Altinn/app-lib-dotnet/issues/692
- [ ] https://github.com/Altinn/app-lib-dotnet/issues/783
- [ ] https://github.com/Altinn/app-lib-dotnet/issues/763
- [ ] https://github.com/Altinn/app-lib-dotnet/issues/760

### Avhengigheter
- [ ] https://github.com/Altinn/altinn-authentication/issues/200
- [ ] https://github.com/Altinn/altinn-storage/issues/501

digdir / roadmap