Systemgrensesnitt
Altinn 3 Formidling Systemgrensesnitt
På denne siden:
Oversikt over Altinn 3 Formidling eksterne grensesnitt
Følgende figur indikerer de viktigste systemgrensesnittene for Altinn 3 Formidling som selvstendig løsning (uten Dialogporten):
Grensesnitt for konfigurering av tjenester og alternativer i designfasen:
- API for konfigurering av Altinn Broker
- API for konfigurering av Maskinporten (autentisering og grovkornet autorisasjon)
- API for konfigurering av Altinn Autorisasjon (finkornet autorisasjon)
- API for oppsett av hendelsesabonnementer via Altinn Hendelser
- GUI for konfigurering av Altinn Broker
- GUI for konfigurering av Maskinporten
- GUI for konfigurering av Altinn Autorisasjon
Merk: Altinn 3 Broker tilbyr inntli videre ikke et eget GUI for filoverføringsoperasjoner, men overlater dette til sluttbrukersystemene.
Grensesnitt for kjøretidsoperasjoner:
- API for individuelle filoverføringer, inkludert opplasting, nedlasting og statusovervåking
Grensesnitt for historiske data og statistikk:
- API for historiske data og statistikk
Altinn 3 Formidling applikasjonstjenester
API-operasjoner
En oversikt over operasjoner i Altinn 3 Formidling API gis av følgende figur:
Merk: Navnene på API-operasjonene er ikke oversatt til norsk, for å unngå misforståelser opp mot tekniske OpenAPI-spesifikasjoner.
Hver av disse applikasjonstjenestene tilsvarer en path i Altinn 3 Formidling OpenAPI spesifikasjon.
Notifikasjoner om hendelser - maskin-til-maskin
Varsler om nye meldinger og andre hendelser leveres til abonnenter av webhooks. De spesifikke hendelsene er spesifisert som en del av Altinn 3 Formidling OpenAPI spesifikasjon.
Oppsummering:
Merk: Navnene på hendelsene er ikke oversatt til norsk, for å unngå misforståelser opp mot tekniske spesifikasjoner.
- filetransferinitialized: Informasjom om en ny filoverføring
- filedeleted: Filen har blitt slettet fra Altinn Formidling
- fileneverconfirmeddownloaded: Filen har ikke blitt bekreftet nedlastet av noen mottaker
- uploadprocessing: Filen har blitt opplastet til Altinn Formidling, og blir kontrollert
- published: Filen er ferdig opplstet og kontrollert, og er klar for nedlasting
- uploadfailed: Filopplasting eller kontroll feilet
- downloadconfirmed: En eller flere mottakere har bekreftet vellykket nedlasting
- allconfirmeddownloaded: Alle aktuelle mottakere har bekreftet vellykket nedlasting
Se også:
- Funksjonalitet for notifikasjon om hendelser i Altinn 3
- Veiledning for oppsett av abonnement på notifikasjon om hendelser i Altinn 3
Varsling til sluttbrukere via e-post og SMS
Varsler til sluttbrukere om nye meldinger, filer og andre hendelser sendes via Altinns varslingstjeneste.
Se også:
Scenariobeskrivelser
Ende-til-ende typisk sekvens
Følgende sekvensdiagram viser typisk “happy path” meldingssekvens:
Merk: Meldingsnavnene er ikke oversatt til norsk, for å unngå misforståelser opp mot tekniske spesifikasjoner.
Meldingene i dette sekvensdiagrammet er realisert som API-kall til applikasjonstjenester. Se Altinn 3 applikasjonstjenester for dokumentasjon av de aktuelle applikasjonstjenestene (API-kallene).
Legg merke til at dette sekvensdiagrammet bare viser utvalgte meldingsparametre. Se Altinn 3 Formidling OpenAPI spesifikasjonen for den komplette dokumentasjonen av parametre.