Sist endret: 2. mai 2024

Altinn 3 Formidling Utviklerguider

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

På denne siden:

    Denne delen av dokumentasjonen er under arbeid, og refererer derfor i stor grad til eksterne kilder.
    For øyeblikket er hendelsene for Broker ikke klare for fullskala bruk, på grunn av kommende endringer i Altinn Events og Autorisasjon. Dette dokumenterer det forventede scenarioet, men kan endres.

    For å bruke hendelser/webhooks for en Broker-ressurs, må du sette opp et abonnement for den gitte ressursen. Dette abonnementet brukes til å konfigurere endepunktet der hendelsene som publiseres av megleren havner. Du kan lese mer om hvordan du setter opp et hendelsesabonnement i Altinn Events her.

    Alle hendelser publisert av Altinn Broker følger det samme mønsteret:

    {
 "id": "1faa107f-3c0a-4fa6-9fce-7cee8838e258",
 "resource": "urn:altinn:resource:altinn-broker-test-resource-1",
 "resourceinstance": "da4ceacc-ad44-4e54-99b6-b58e3c13c785",
 "source": "https://platform.tt02.altinn.no/broker/api/v1/filetransfer",
 "specversion": "1.0",
 "type": "no.altinn.broker.Published",
 "subject": "/party/50015641",
 "alternativesubject": "/organisation/123456789",
 "time": "2024-04-19T07:22:19.438039Z"
}

    Hendelsesabonnement

    Dette abonnementet brukes til å konfigurere endepunktet der hendelsene som publiseres av Atlinn Broker skal leveres. Du kan lese mer om hvordan du setter opp et hendelsesabonnement i Altinn Events her.

    Du må sette opp følgende filtre:

    Alternativesubjectfilter brukes til å begrense Event til bare den autoriserte avsenderen eller mottakeren for den spesifikke hendelsen, dette sikrer innholdet og reduserer synlighet.

    Resourceinstance vil alltid være det samme som FileTransferId for Filoverføringen.

    I tillegg kan du ønske å bruke typeFilter, slik at du mottar hendelsestypene du er interessert i/kan utføre handlinger på. Hvis du ikke spesifiserer et typeFilter, vil du motta alle forskjellige typer hendelser, gitt at du har tilgang til dem.

    For Avsendere:

    • no.altinn.broker.filetransferinitialized
    • no.altinn.broker.uploadprocessing
    • no.altinn.broker.uploadfailed
    • no.altinn.broker.allconfirmeddownloaded
    • no.altinn.broker.filepurged

    For både Avsendere og Mottakere:

    • no.altinn.broker.published
    • no.altinn.broker.downloadconfirmed
    • no.altinn.broker.fileneverconfirmeddownloaded

    For ytterligere beskrivelse av hendelser og deres bruk, se utviklerguider for sende filer og motta filer, da disse beskriver hendelsene i forhold til de respektive rollene/prosessene.