Version November 2025  

KLE-REST udstiller emnesystematikken KLE som RESTful web service.

Ophavsret

Anvendelse af KL Emnesystematik og dertil hørende services kræver i alle forhold et skriftligt samtykke. KL forbeholder sig alle rettigheder til den administrative taksonomi og deraf følgende systematik, jvf. Bernerkonventionen og den deraf følgende gældende danske lov om ophavsret. Kontakt KL, Flemming Nielsen, fln@kl.dk for indgåelse af aftale, forud for anvendelse.

Skemaer

Samtlige REST-skemaer, samt tidligere udgaver kan tilgås her:

Dokumentation

Her følger en dokumentation af de forskellige funktioner, der er tilgængelige i KLE-REST.

Som udgangspunkt er udgåede elementer IKKE er inkluderet i de returnerede data. Hvis du ønsker at få udgåede elementer med i resultatet, så skal du tilføje parameteren "udgaaede=true" på REST-kaldet. F.eks.

UUID'er er som udgangspunkt kun inkluderet i de fulde udgaver af hhv. emneplan og handlingsfacetter (se nedenfor). Det er dog muligt at få UUID'er inkluderet ved at tilføje parameteren "uuid=true" til url'en. F.eks.

Emneplan

Emneplanen er tilgængelig via de tre grundlæggende resourcetyper: Hovedgrupper, grupper og emner.

Ved kald af ovenstående url'er returnerer rest-servicen en "listevisning" af samtlige aktive hovedgrupper, grupper eller emner i den nuværende udgave af KLE. Resultatet bliver leveret som XML.

Listevisningen indeholder kun helt grundlæggende oplysninger om den/det enkelte hovedgruppe, gruppe eller emne.

Detaljevisning

For at returnere samtlige attributter på et KLE-element kan man kalde følgende funktioner med det pågældende elements nummer.

Et kald af ovenstående URL'er med et aktivt KLE-nummer returnerer en "detaljevisning" af det enkelte KLE-element. URL-henvisninger til de enkelte elementer står også angivet i ref-attributten i listevisningen.

Detaljevisningen af hovedgrupper og grupper inkluderer også en liste af hhv. grupper og emner, som er inkluderet i hovedgruppen eller gruppen.

Fuld emneplan og alle handlingsfacetter

Det er muligt at få returneret den fulde emneplan i et KLE XML 2.0-lignende format, som dog også inkluderer stikord (hvad KLE XML 2.0 ikke gør).

De komplette udgaver af hhv. emneplan og handlingsfacetter indeholder IKKE udgåede elementer som udgangspunkt. Hvis man vil have udgåede elementer med kan det foregå på én af følgende måder:

  • http://api.kle-online.dk/resources/kle/emneplan?udgaaede=true (inklusive alle udgåede elementer)
  • http://api.kle-online.dk/resources/kle/emneplan?dato-start=2007-01-01 (inklusive udgåede elementer, som er udgået fra datoen 01.01.2007)
  • http://api.kle-online.dk/resources/kle/emneplan?dato-slut=2006-12-31 (inklusive udgåede elementer, som er udgået før eller på datoen 31.12.2016)

    • Bemærk at download af udgave med udgåede kan tage op til et minut.

    Historik

    Alle hovedgrupper, grupper og emner har en redigeringshistorik med en dato for oprettelse, seneste rettelse og evt. ugåetdato. Det er muligt at hente denne historik for alle eller udvalgte emner:

  • http://api.kle-online.dk/resources/historik/emner/?dato-start=1971-01-01&dato-slut=2100-01-01 (Historik på emner, grupper og hovedgrupper oprettet, rettet eller nedlagt i det angivne tidsinterval)
  • http://api.kle-online.dk/resources/historik/emne/54.18.11 (Historik på et enkelt emne, gruppe eller hovedgruppe)

    • Handlingsfacetter

    Handlingsfacetterne er tilgængelige via de to grundlæggende resourcetyper: Handlingsfacetkategori og handlingsfacet.

    Som med elementerne fra emneplanen så indeholder listevisningen af handlingsfacetterne kun de helt grundlæggende oplysninger om den enkelte handlingsfacet.

    Detaljevisning

    For at returnere samtlige attributter på en handlingsfacet kan man kalde følgende funktioner med den pågældende handlingsfacets nummer.

    Stikord

    Et stikord er en tekststreng, som peger på et KLE-element (hovedgruppe, gruppe, emne eller handlingsfacet), eller på en kombination af en hovedgruppe, gruppe eller emne og en handlingsfacet.

    Et stikord kan også være et såkaldt retskildestikord, som er titlen på en given retskilde (f.eks. lov eller bekendtgørelse), som en given gruppe eller et givent emne peger på.

    Stikord kan anvendes i søge- og opslagssammenhæng, og kan i REST-interfacet tilgås på basis af enten et hovedgruppenummer, gruppenummer, emnenummer eller handlingsfacetnummer. Det er IKKE muligt at hente samtlige stikord i KLE via et enkelt REST-kald.

    Der følgende muligheder for kald af stikordsfunktionen:

    Eksemplet for emnet 17.03.09 inderholder både almindelige stikord samt retskildestikord.

    Indenrigsministeriets kontoplan

    Indenrigsministeriets kontoplan er en del af budget- og regnskabssystem for kommuner, også kaldet den autoriserede kontoplan (læs mere her).

    KLE-redaktionen har udarbejdet en BETA XML-opmærket udgave af kontoplanen til brug i KLE-online (se skema).

    Der følgende muligheder for kald af kontoplansfunktionen:

    Adgang til at læse kontoplanen kræver login og password, som kan udleveres ved henvendelse til Flemming Nielsen (fln@kl.dk).