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.- Læs tutorials til enten Javascript klienten eller PHP klienten
- Brug
https://api.danskkulturarv.dk
somServicePath
, og kontakt danskkulturarv@dr.dk for at få ditAccessPointGUID
- 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 etMetadataSchemaGUID
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.
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 |