Sist endret: 4. sep. 2026

Forsendelse

Referanseinformasjon om forsendelsesentiteten

Select environment: Help
This dropdown lets you select which Dialogporten environment the content of this page should be based on. If unsure, use the default "Staging (TT02)", as this is the environment you would normally test against when integrating Dialogporten.

For bleeding edge, select "Dev", as this contains the most recent unreleased changes to the Dialogporten API. Select "Local dev" if you want to test changes to Dialogporten itself running locally.

Schemaet nedenfor viser sluttbrukerentiteten for forsendelse som returneres fra dialogdetaljer.

En forsendelse representerer én uforanderlig kommunikasjonsenhet inni en dialog. Listen over forsendelser kan bare utvides; eksisterende forsendelser oppdateres ikke eller fjernes ikke.

Viktige deler av forsendelsesmodellen er:

  • type, som angir implementert forsendelseskategori som Information, Acceptance, Rejection, Request, Alert, Decision, Submission eller Correction
  • sender, som identifiserer om forsendelsen kom fra tjenesteeieren eller en partsrepresentant
  • en autorisasjonskontekst (foretrukket), som kan evaluere tilgang til forsendelsen mot en annen ressurs, flere parter, eller begge deler
  • authorizationAttribute (utfaset), som kan overstyre standard autorisasjonsressurs brukt for forsendelsen
  • relatedTransmissionId, som knytter forsendelsen til en annen forsendelse når tjenesteeieren ønsker å uttrykke den relasjonen
  • content, attachments og navigationalActions, som inneholder den forsendelsesspesifikke presentasjons- og navigasjonsdataen

I sluttbruker-API-er forteller isAuthorized deg om den autentiserte brukeren kan få tilgang til innholdet i forsendelsen. Hvis tilgang nektes, avgjør forsendelsens unauthorizedPresentation hva som skjer: Disabled lar forsendelsen bli liggende i listen, maskerer den innebygde innholdsreferansen og URL-ene til de underliggende delene, og lar resten av innholdet være lesbart, mens Excluded fjerner forsendelsen fra transmissions og legger ID-en og opprettelsestidspunktet i excludedTransmissions ved siden av - de underliggende delene følger med. Når forsendelsen har en autorisasjonskontekst den nåværende brukeren er autorisert for, lister dialogtokenet opp forsendelsens id (eller kontekstens tokenRef) i e-claimet sitt; dialogtokenet brukes mot URL-ene til forsendelsen som vanlig, også for front channel embed.

De frittstående forsendelsesendepunktene følger den samme regelen: GET etter ID svarer 403 Forbidden for en utelukket forsendelse, og forsendelseslisten utelater den ganske enkelt.

Tjenesteeier-API-ene eksponerer det samme forsendelseskonseptet i tjenesteeierens dialogentitet og i endepunktene for tjenesteeierforsendelser.

Les mer