Altinn 3 Formidling Utviklerguide for Avsender
Hvordan komme i gang med å sende filer med Altinn 3 Formidling, for utviklere
På denne siden:
Her er de detaljerte API-operasjonene og hendelsene du vil bruke når du sender filer.
Se også vår swagger-side.
Operasjon: Initialiser Filoverføring
Endepunkt: POST /broker/api/v1/filetransfer/
Denne operasjonen initialiserer en filoverføring, inkludert validering av grunnleggende metadata og autorisasjon hvis mottaker(e) spesifisert er gyldige.
Forespørsel: En instans av FileInitializeExt serialisert som JSON.
Return: HTTP 200 med GUID-en FileTransferID som er den unike ID-en brukt til å identifisere denne filoverføringen.
Utløste hendelser:
- Når fullført, blir hendelsen filetransferinitialized publisert til avsenderen, noe som indikerer at filoverføringen har blitt vellykket initialisert.
Eksempel: ‘Broker\Intitialize’ i vår PostMan-samling
Operasjon: Last opp strømmet
Endepunkt: POST /broker/api/v1/filetransfer/{fileTransferId}/Upload
Last opp fildataene som en strøm ved hjelp av FileTransferId mottatt i InitialiserFileTransfer.
Forespørsel: FileTransferID spesifisert i URLen, og dataene som en strøm.
Return: HTTP 200 hvis vellykket fullført.
Utløste hendelser:
- Ved fullføring blir hendelsen uploadprocessing publisert, og en asynkron jobb vil kjøre for å sjekke fildataene for skadelig programvare.
- Når opplastingsbehandlingen har blitt vellykket fullført, blir hendelsen published publisert, og filen er tilgjengelig for nedlasting.
- Hvis skadelig programvare ble oppdaget, blir hendelsen uploadfailed i stedet publisert.
Eksempel: ‘Broker{fileTransferId}\upload’ i vår PostMan-samling
Operasjon: Hent Filoverføringsoversikt
Endepunkt: GET /broker/api/v1/filetransfer/{fileTransferId}
Få en enkel oversikt over filoverføringen med gjeldende status og mottakerstatus.
Respons: En JSON-seralisert versjon av FileTransferOverviewExt
Utløste hendelser: ingen.
Eksempel: ‘Broker{fileTransferId}\overview’ i vår PostMan-samling
Operasjon: Hent Filoverføringsdetaljer
Endepunkt: GET /broker/api/v1/filetransfer/{fileTransferId}/details
Få en detaljert visning av filoverføringen, inkludert detaljerte filoverførings- og mottakerstatuser. Nyttig for feilsøking, men bør brukes sparsomt.
Forespørsel: FiletransferId spesifisert i URLen.
Respons: En JSON-seralisert versjon av FileTransferStatusDetailsExt
Utløste hendelser: ingen.
Eksempel: ‘Broker{fileTransferId}\details’ i vår PostMan-samling
Hendelse: no.altinn.broker.filetransferinitialized
Denne hendelsen utløses når initialiseringsoperasjonen har blitt fullført vellykket. Som Avsender kan du nå laste opp fildataene dine.
Hendelse: no.altinn.broker.uploadprocessing
Denne hendelsen utløses når opplastingsoperasjonen har blitt fullført vellykket, og fildataene venter på opplastingsbehandling. Frem til du mottar enten uploadfailed eller published, trenger ingen handlinger å utføres.
Hendelse: no.altinn.broker.uploadfailed
Denne hendelsen utløses hvis enten opplastings- eller opplastingsbehandlingsstegene mislykkes. Vi anbefaler deg å kalle get overview for å sjekke hvilke feilmeldinger som ble gitt.
Hendelse: no.altinn.broker.published
Denne hendelsen utløses når den asynkrone opplastingsprosessen har blitt fullført vellykket. Som avsender trenger du ikke å utføre noen ekstra handlinger.
Hendelse: no.altinn.broker.downloadconfirmed
Denne hendelsen utløses når en mottaker har bekreftet at nedlastingen har blitt fullført vellykket.
Hendelse: no.altinn.broker.allconfirmeddownloaded
Denne hendelsen utløses når alle mottakerne har bekreftet at nedlastingen har blitt fullført. Hvis FileTransfer har en enkelt mottaker, vil dette bli publisert samtidig som downloadconfirmed. Avhengig av innstillingene for Broker-tjenesten kan dette føre til at filen blir automatisk slettet.
Hendelse: no.altinn.broker.fileneverconfirmeddownloaded
Denne hendelsen utløses ved ExpiryTime for FileTransfer i tilfelle en eller flere mottakere ikke har bekreftet nedlastingen av filen. Dette kan indikere at enten mottakeren ikke var klar over FileTransfer eller at de har lastet ned, men unnlot å kalle ConfirmDownload. Denne hendelsen sendes også til mottaker(ne) som ikke har bekreftet nedlastingen.
Vi foreslår å bruke dataene som leveres i hent filoverførings detaljer for å undersøke hvilke handlinger mottakerne har utført på filoverføringen.
Hendelse: no.altinn.broker.filedpurged
Denne hendelsen utløses av filopprydningsprosessen ved Expiry av filen eller når alle mottakerne har bekreftet nedlastingen.
Etter dette punktet er fildataene ikke lenger tilgjengelige for nedlasting, selv om metadataene forblir.