Sist endret: 4. sep. 2024

Altinn 3 Correspondence Utviklerguider

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

    Denne delen av dokumentasjonen er under arbeid, og refererer derfor i stor grad til eksterne kilder.
    For øyeblikket er hendelsene for Melding 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 meldingstjeneste, 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 Melding følger det samme mønsteret:

    {
 "id": "1faa107f-3c0a-4fa6-9fce-7cee8838e258",
 "resource": "urn:altinn:resource:altinn-correspondence-test-resource-1",
 "resourceinstance": "da4ceacc-ad44-4e54-99b6-b58e3c13c785",
 "source": "https://platform.tt02.altinn.no/correspondence/api/v1/correspondence",
 "specversion": "1.0",
 "type": "no.altinn.correspondence.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 Melding 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 CorrespondenceId for Meldingen.

    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 Avsender:

    • no.altinn.correspondence.attachmentinitialized

    • no.altinn.correspondence.attachmentuploadprocessing

    • no.altinn.correspondence.attachmentpublished

    • no.altinn.correspondence.attachmentuploadfailed

    • no.altinn.correspondence.attachmentpurged

    • no.altinn.correspondence.correspondenceinitialized

    • no.altinn.correspondence.correspondencearchived

    • no.altinn.correspondence.correspondencepurged

    • no.altinn.correspondence.correspondencepublishfailed

    • no.altinn.correspondence.correspondencereceiverread

    • no.altinn.correspondence.correspondencereceiverconfirmed

    • no.altinn.correspondence.Correspondencereceiverreserved

    For både Avsendere og Mottakere:

    • no.altinn.correspondence.correspondencepublished
    • no.altinn.correspondence.correspondencereceiverneverread
    • no.altinn.correspondence.correspondencereceiverneverconfirmed