Versionshistorik - Version 2.0

Digitalt Samtykke API - Digitaliseringsstyrelsen

Ændringer i API v2

Ændring

Fjernet Borger.dk API-endpoints

Endpoints relateret til Borger.dk's benyttelse af løsningen er fjernet.

Ny funktionalitet

Skabelonversion er nu indeholdt i referencen på samtykkeerklæringer

Samtykkeerklæringer skal nu indeholde reference til en specifik skabelonversion ved hjælp af SkabelonUUID og SkabelonVersion. Begge felter er påkrævede i XML-udvekslingsformatet og API'et.

SkabelonUUID: UUID der identificerer skabelonen (påkrævet felt)
SkabelonVersion: Heltal der angiver versionsnummer (f.eks. 1, 2, 3) (påkrævet felt)

Vigtige egenskaber

  • API'et validerer ikke at UUID + Version eksisterer i systemet - erklæringer kan referere til skabeloner der ikke findes
  • Felterne fungerer som metadata på erklæringen for sporbarhed mellem eksterne skabelonsystemer og Digitalt Samtykke
Skemaændring

SamtykkeErklaering 2026-03

Samtykkeerklæringer skal nu indeholde et påkrævet element SamtykkeErklaeringSkabelonReference med reference til den samtykkeerklæringsskabelon (UUID + version) som erklæringen er baseret på. Referencen erstatter den tidligere SkabelonReference

Element: SamtykkeErklaeringSkabelonReference (påkrævet)
Child elementer:
  • SkabelonUUID - UUID for skabelonen (påkrævet)
  • SkabelonVersion - Heltal der angiver versionsnummer (påkrævet)
Namespace: urn:digst:samtykke:samtykkeerklaeringdatatyper:2026-03
Ændring

Omdøbt RegistrerAfvisteOgIkkeValgte til RegistrerIkkeValgteValgmuligheder

Elementet RegistrerAfvisteOgIkkeValgte på SamtykkeSkabelon er blevet ændret til RegistrerIkkeValgteValgmuligheder. Dette skyldes, at navnet ikke var retvisende for funktionaliteten, hvilket angiver, om ikke-valgte valgmuligheder skal registreres som afviste i den endelige samtykkeerklæring.

Skemaændring

ErklæringSkabelon 2026-03

Elementet RegistrerAfvisteOgIkkeValgte på SamtykkeSkabelon er omdøbt til RegistrerIkkeValgteValgmuligheder i XML-skemaet.

Namespace: urn:digst:samtykke:samtykkeerklaeringskabelon:2026-03
Ændring

Maksimal længde på Navn-feltet

Elementet Navn på SamtykkeErklaering har nu en maksimal længde på 200 tegn for at sikre konsistent navngivning og undgå problemer med lange navne.

Skemaændring

SamtykkeErklaering 2026-03

Element: SamtykkeErklaering/Navn
Type: Max200TekstType
Max længde: 200 tegn
Namespace: urn:digst:samtykke:samtykkeerklaeringdatatyper:2026-03
Ændring

Fjernet understøttelse af flere subjekter

Der er ikke længere understøttelse af flere subjekter på en Samtykkeerklæring. Svar fra alle v2 endpoints og XML-udvekslingsformatet er opdateret til at afspejle dette.

Skemaændring

Samtykke og SamtykkeErklaering 2026-03

Skemaversionen er opdateret til "2026-03" for alle skemær relateret til samtykkeerklæringer.

Namespaces:
  • urn:digst:samtykke:samtykkeerklaering:2026-03
  • urn:digst:samtykke:samtykke:2026-03
  • urn:digst:samtykke:samtykkeerklaeringdatatyper:2026-03

Ændringer:

  • Subjekt2-felter fjernet fra alle skemaer
  • XML-strukturen understøtter nu kun ét subjekt pr. samtykkeerklæring
Skemaændring

ErklæringSkabelon 2026-03

Skemaversionen er opdateret til "2026-03".

Namespace: urn:digst:samtykke:samtykkeerklaeringskabelon:2026-03

Ændringer:

  • Attributten tilladFlereSubjekter på SamtykkeErklaeringsSkabelon er blevet fjernet.
  • Det er ikke længere muligt at oprette en samtykkeerklæringsskabelon, der understøtter flere subjekter.
Ændring

Parameter omdøbt

På endpointet /v2/api/myndighed/{cvrNummer}/samtykker er query-parameteren SamtykkeGruppeSkabelonUuid omdøbt til SamtykkeSkabelonId.

V1

Parameter navn: SamtykkeGruppeSkabelonUuid
Beskrivelse: Hvis angivet, så ID'er på en eller flere samtykkegruppeskabeloner

V2

Parameter navn: SamtykkeSkabelonId
Beskrivelse: Hvis angivet, så ID'er på en eller flere samtykkeskabeloner. Et samtykkeSkabelonId angiver den samtykkeskabelon som samtykkegruppen og dens samtykker er dannet på baggrund af. Kan bruges til at hente ensartede samtykker ud.
Ny funktionalitet

Versionering af samtykkeerklæringsskabeloner

Samtykkeerklæringsskabeloner understøtter nu versionering. API'et returnerer alle versioner af hver skabelon, så integrationer kan se historik og få adgang til alle tilgængelige versioner.

Sådan fungerer versionering

  • Hver samtykkeerklæringsskabelon har et ErklaeringSkabelonUuid som identificerer skabelonen på tværs af versioner
  • Hver version af skabelonen har et SkabelonVersion felt (heltal: 1, 2, 3, osv.)
  • Listen af skabeloner returnerer alle versioner i Versioner-arrayet
  • Flere versioner af samme skabelon kan eksistere samtidig i systemet
  • Ved hentning af en specifik skabelon uden versionsnummer returneres den seneste version
  • Ved hentning af en specifik version af en specifik skabelon returneres den pågældende version
Skemaændring

ErklæringSkabelon 2026-03

Samtykkeerklæringsskabelon XML'en inkluderer nu attributten skabelonVersion ved download fra API'et og GUI.

Type: xs:int (heltal)
Anvendelse: Ignoreres ved upload, inkluderes altid ved download
Namespace: urn:digst:samtykke:samtykkeerklaeringskabelon:2026-03

Ved upload: Attributten er valgfri og vil blive ignoreret. Systemet tildeler automatisk det næste tilgængelige versionsnummer.

Ved download: Attributten inkluderes altid og angiver den reelle versionsnummer for den downloadede skabelon.

Eksempel: <SamtykkeErklaeringsSkabelon skabelonVersion="3" samtykkeErklaeringsSkabelonUUID="..." ...>

Ny funktionalitet

Kontrol over borgers tilbagekaldelsesmulighed

Myndighederne kan nu styre om borgere selv må tilbagekalde samtykker, eller om de skal kontakte myndigheden.

Skemaændring

ErklæringSkabelon 2026-03

Nyt valgfrit attribut tilladBorgerTilbagekaldelse på SamtykkeSkabelonTrin-elementet i ErklæringSkabelon-skemaet.

Type: boolean
Default: true (bagudkompatibel)
Namespace: urn:digst:samtykke:samtykkeerklaeringskabelon:2026-03

Adfærd når tilladBorgerTilbagekaldelse="false":

  • Borgeren kan ikke selv tilbagekalde samtykket via selvbetjening
  • I stedet vises kontaktoplysninger for den ansvarlige myndighed
  • Myndigheden kan stadig tilbagekalde samtykket via API eller administration
Skemaændring

Samtykke 2026-03

Nyt valgfrit attribut tilladerBorgerTilbagekaldelse på Samtykke-elementet i Samtykke-skemaet.

Type: boolean
Default: true (bagudkompatibel)
Namespace: urn:digst:samtykke:samtykke:2026-03

Anvendelse:

  • Angiver om borgeren selv har mulighed for at tilbagekalde samtykket eller skal kontakte myndigheden
  • Arves fra tilladBorgerTilbagekaldelse på SamtykkeSkabelonTrin i skabelonen
Ny funktionalitet

Endpoint for Status tjek på API'et'

Der er tilføjet et nyt endpoint, der kan bruges til at tjekke status på API'et. Det kræver en valid token og client certificate at kalde.

Formål: Gør det muligt for anvender systemer at overvåge Digitalt Samtykkes tilstand.

Bemærk: Det er rate limit på endpointet. Det kan kaldes 1 gang per 5. minut.

Ny funktionalitet

Understøttelse af lang-attributten på HTML-elementer

Alle accepterede HTML-elementer i skabeloner understøtter nu lang-attributten for at specificere sprog på elementniveau.

Skemaændring

xhtml-limited.xsd

lang-attributten er tilføjet til alle HTML-elementtyper i xhtml-limited.xsd skemaet.

Påvirker: ErklæringSkabelon 2026-03 og alle andre skemaer der bruger HTML-elementer
Type: xs:language