Sist endret: 4. sep. 2026

Handling

Referanseinformasjon om handlingsentitetene

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.

Handlinger beskriver operasjoner som sluttbrukeren eller en klientintegrasjon kan utføre i forbindelse med en dialog.

Både GUI-handlinger og API-handlinger deler den samme grunnleggende autorisasjonsmodellen:

  • action mappes til en handlingsidentifikator i policyen for tjenesteressursen
  • en autorisasjonskontekst (foretrukket) kan evaluere handlingen mot en annen ressurs, flere parter, eller begge deler
  • authorizationAttribute (utfaset) kan overstyre standard autorisasjonsressurs for handlingen
  • isAuthorized viser om den autentiserte brukeren er autorisert akkurat nå
  • når handlingen har en autorisasjonskontekst den nåværende brukeren er autorisert for, lister dialogtokenet opp handlingens id (eller kontekstens tokenRef) i e-claimet sitt i stedet for å legge handlingen til i a-claimet

I sluttbruker-API-er maskeres URL-ene til en uautorisert handling:

  • URL-er for GUI-handlinger skrives om til urn:dialogporten:unauthorized
  • URL-er for endepunkter i API-handlinger skrives om til urn:dialogporten:unauthorized

En handling der autorisasjonskonteksten setter unauthorizedPresentation til Excluded, maskeres ikke, men fjernes: den forsvinner ut av guiActions eller apiActions, og bare ID-en og opprettelsestidspunktet vises i excludedGuiActions eller excludedApiActions ved siden av.

GUI-handlinger er ment for nettleserbaserte fronter og legger til UI-spesifikke felt som:

  • priority
  • httpMethod
  • title
  • valgfri prompt
  • isDeleteDialogAction

API-handlinger er ment for klientintegrasjoner og grupperer ett eller flere versjonerte endepunkter. Hvert endepunkt kan eksponere:

  • version
  • url
  • httpMethod
  • valgfri documentationUrl
  • valgfri requestSchema
  • valgfri responseSchema
  • deprecated
  • valgfri sunsetAt

GUI-handlinger

API-handlinger

Les mer