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 http://api.danskkulturarv.dk som ServicePath, og udfyld denne lille formular 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:

TagIndholdObligatoriskTilgængelighed
TitleNavnet på objektet92.9%
AbstractEn kort beskrivelse af objektet. Dette felt er desværre ubrugt0.0%
DescriptionBeskrivelse af objektet som HTML99.4%
OrganizationOrganisationen der besitder det pågældende objekt
Eksempler: "Det Kongelige Bibliotek", "DR", "Lokalhistorisk Arkiv, Brande Bibliotek (via Det Kongelige Bibliotek)"
100.0%
ExternalURLURL til organisationens egen side om objektet99.9%
ExternalIdentifierOrganisationens eget ID for objektet Kan som udgangspunkt ignoreres medmindre du ønsker at sammenholde objektet med yderligere fra organisationens egne databaser.97.6%
TypeKan ignoreres99.9%
CreatedDateKan ignoreres8.5%
FirstPublishedDateAngiver 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%
ContributorsRefererer til personer "foran kameraet" eksempelvis skuespillere. (Termet er lånt fra Dublin Core standarden)6.3%
ContributorHar attributterne Name (Obligatorisk) og Role der er hhv. navn og rolle for personen.
Contributors
CreatorsRefererer til personer "bag kameraet" eksempelvis instruktør, manuskriptforfatter og lignende. (Termet er lånt fra Dublin Core standarden)48.5%
CreatorHar attributterne Name (Obligatorisk) og Role (Valgfri) der er hhv. navn og rolle for personen.
Creators
TechnicalCommentTeknisk 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%
LocationGenerel beskrivelse af hvor mediet er fra.
Eksempler: "Museet for Dansk Bladtegning", "Danmark, København", "Danmark, Ribe"
26.6%
RightsDescriptionKort 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%
GeoDataDette 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%
LatitudeLængdegrad
Eksempler: "55.657507", "55.620242"
LongtitudeBreddegrad
Eksempler: "12.591361", "12.075862"
GeoData
CategoriesDette felt er primært på materiale fra DR og angiver typisk hvilken genre mediet tilhører.10.2%
CategoryEksempler: "Stumfilm", "Ung & Satire", "DK/Dokumentarfilm", "Musik", "Drama"
Categories
TagsTags 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%
TagEksempler: "Brandes, Georg (1842-1927) kritiker, forfatter", "militærvæsen", "1906-1908"
Tags
MetafieldFelt til evt. ekstra-information (OBS: kan forekomme flere gange)7.9%
KeyFeltnavn
ValueVærdi
Metafield

Eksempel på CHAOS objekt

Her kan du hente et objekt ud af databasen.