For udviklere

DR's programoversigter

Guide for DR's programoversigter kan findes her.

API'et

Via danskkulturarv.dk's API kan du bruge de samme medier du finder på siden i dine egne applikationer. Danskkulturarv.dk's mediadatabase kører på en backend, der hedder CHAOS. Gennem CHAOS kan du hente medierne og oplysninger om dem, og præsentere dem på dit eget site eller i din egen applikation. Den nemmeste måde at bruge CHAOS er vha. CHAOS Javascript og PHP-klienterne.
  1. Læs tutorials til enten Javascript klienten eller PHP klienten
  2. Brug https://api.danskkulturarv.dk som ServicePath, og kontakt danskkulturarv@dr.dk for at få dit AccessPointGUID
  3. Brug den tilknyttede metadata til at præsentere medierne i din applikation.

Rettigheder og brug

Webservicen kan benyttes frit inden for rimelighedens grænser – der er ikke ubegrænset kapacitet på vores servere. Medierne kan som udganspunkt kun bruges i forbindelse med Hack4DK, ønsker du adgang i længere tid så kontakt venligst danskkulturarv.dk. Medierne i databasen er underlagt visse rettighedslicenser f.eks. angående kommerciel brug og kreditering af institutionen, der har stillet mediet til rådighed.
  • Må ændres?: om materialet må "remixes"
  • Bruges kommercielt?: om materialet må bruges i en kommerciel sammenhæng
  • Kreditering?: om organisationen skal krediteres når du bruger deres materialer
  • Del under samme vilkår?: hvis du laver ændringer skal du dele dine ændringer under samme licens/betingelser
  • Vælg: I denne sidste kolonne kan du vælge hvilke organisationer du ønsker at få medier fra. En tekstboks vil i tilfælde af fravalg vise en streng som du skal inkludere i dine queries for at vælge netop disse organisationer
Hvis du ønsker kun at få resultater fra de valgte organisationer, skal du bruge følgende query

Metadata

Vi anbefaler at du bruger DKA2 skemaet som kilde til information om medier de du finder gennem API'et. Hvert objekt du får tilbage fra API'et har en række metadata XML-dokumenter tilknyttet. Du kan finde dét XML-dokument der efterlever DKA2 skemaet ved finde metadata, der har et MetadataSchemaGUID som er 5906a41b-feae-48db-bfb7-714b3e105396. 97,8% af objekterne du kan tilgå via api.danskkulturarv.dk har DKA2-metadata tilknyttet. Du kan finde DKA2 skemaets XML-specifikationen her: DKA2.xsd. Obligatorisk angiver om feltet skal optræde i XML-dokumentet, eller om det blot er valgfrit og dermed ikke altid kan forventes at optræde. Selvom feltet er til stede i XML-dokumentet, kan det godt være tomt. Dette er eksempelvis tilfældet med <Abstract>. Tilgængelighed beskriver hvor stor en procentdel af objekterne på danskkulturarv.dk du kan forvente er annoteret med det pågældende metadata-felt. Dette angiver om et felt har indhold og dermed ikke er tomt.
  • Rækker markeret med rød baggrundsfarve er felter med lav tilgængelighed, og som derfor ikke bør benyttes.
  • Rækker markeret med grøn baggrundsfarve er felter med høj tilgængelighed, som kan bruges.
  • Rækker markeret med grå baggrundsfarve kan ignoreres.
I skemaet (og dermed i metadataen) findes følgende felter:
Tag Indhold Obligatorisk Tilgængelighed
Title Navnet på objektet 92.9%
Abstract En kort beskrivelse af objektet. Dette felt er desværre ubrugt 0.0%
Description Beskrivelse af objektet som HTML 99.4%
Organization Organisationen der besitder det pågældende objekt Eksempler: "Det Kongelige Bibliotek", "DR", "Lokalhistorisk Arkiv, Brande Bibliotek (via Det Kongelige Bibliotek)" 100.0%
ExternalURL URL til organisationens egen side om objektet 99.9%
ExternalIdentifier Organisationens eget ID for objektet Kan som udgangspunkt ignoreres medmindre du ønsker at sammenholde objektet med yderligere fra organisationens egne databaser. 97.6%
Type Kan ignoreres 99.9%
CreatedDate Kan ignoreres 8.5%
FirstPublishedDate Angiver hvornår mediet første gang blev publiceret Er det et TV-program vil det eksempelvis være første gang det blev sendt i fjernsynet. Feltet er ikke 100% pålideligt. 10.4%
Contributors Refererer til personer "foran kameraet" eksempelvis skuespillere. (Termet er lånt fra Dublin Core standarden) 6.3%
Contributor Har attributterne Name (Obligatorisk) og Role der er hhv. navn og rolle for personen.
Contributors
Creators Refererer til personer "bag kameraet" eksempelvis instruktør, manuskriptforfatter og lignende. (Termet er lånt fra Dublin Core standarden) 48.5%
Creator Har attributterne Name (Obligatorisk) og Role (Valgfri) der er hhv. navn og rolle for personen.
Creators
TechnicalComment Teknisk beskrivelse af mediet, f.eks. hvilken slags maling eller film der er brugt. Eksempler: "Format: meter 35 mm 1.33 sort-hvid stum/silent", "Format: 35 mm 1.37 Eastmancolor tone/sound", "Olie på lærred" 2.4%
Location Generel beskrivelse af hvor mediet er fra. Eksempler: "Museet for Dansk Bladtegning", "Danmark, København", "Danmark, Ribe" 26.6%
RightsDescription Kort copyright-besked eller anden kort rettighedsangivelse Eksempler: "Copyright © The Royal Library: The National Library of Denmark and Copenhagen University Library", "Attribution-NonCommercial-ShareAlike License (http://creativecommons.org/licenses/by-nc-sa/2.0/)" 99.9%
GeoData Dette felt er til eventuelle geodata for mediet, som beskriver hvor der er optaget/fotograferet eller lignende. Generelt set er der ikke geodata på objekterne, men der er på nogle få billeder angivet hvor billedet blev taget. 0.5%
Latitude Længdegrad Eksempler: "55.657507", "55.620242"
Longtitude Breddegrad Eksempler: "12.591361", "12.075862"
GeoData
Categories Dette felt er primært på materiale fra DR og angiver typisk hvilken genre mediet tilhører. 10.2%
Category Eksempler: "Stumfilm", "Ung & Satire", "DK/Dokumentarfilm", "Musik", "Drama"
Categories
Tags Tags angiver meget kort hvad mediet omhandler. Er mediet for eksempel fra en samling kan mediet være tagget med samlingens navn eller emne. 69.8%
Tag Eksempler: "Brandes, Georg (1842-1927) kritiker, forfatter", "militærvæsen", "1906-1908"
Tags
Metafield Felt til evt. ekstra-information (OBS: kan forekomme flere gange) 7.9%
Key Feltnavn
Value Værdi
Metafield

Eksempel på CHAOS objekt

Her kan du hente et objekt ud af databasen.