Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Section
Column

Description

Excerpt
The method edm returns the Europeana Data Model (DDB profile) of an item for a given item-ID. This method provides response data as application/json and application/xml. It is a read-only service and must be accessed with a HTTP-GET-request.
Code Block
languagetext
GET /items/<PathParameters>/edm?<QueryParameters> HTTP/1.1
Column
width30%
Noprint
Panel
titleContent of this page

Table of Contents
maxLevel2

Request Header

NameValue(s)RequiredRepeatableDefault valueDescription
Acceptapplication/json
application/xml
*/*
yesnoapplication/jsonSpecifies the format of the accepted data. Every request needs to be sent with a valid Accept Header defining the requested response format. Otherwise the response to the request will be a 406 - Not acceptable status code. If the request accepts every kind of data (Accept: */*) JSON will be returned.
AuthorizationOAuth oauth_consumer_key="<API key>"yesnoAn API key is mandatory for data access. You may enclose it by either sending it as Query Parameter or (as mentioned here) in the Request Header.
Hostapi.deutsche-digitale-bibliothek.deyesnoThe host is mandatory.
Noprint
Section

Back To Top

Parameters

Path

ParameterValue(s)RequiredRepeatableDefault valueDescription
identifier<item-ID>yesnoThe ID of the requested item.

 

Query

ParameterValue(s)RequiredRepeatableDefault valueDescription
oauth_consumer_key<API key>yesnoAn API key is mandatory for data access. You may enclose it by either sending it as Query Parameter or (as mentioned here) in the Request Header.
Noprint
Section

Back To Top

Authorization

This method needs an API key for authentication (Who are you?) and authorization (What you are authorized to do?). For more information please read the Authorization How-To.

This method is offered over HTTP and HTTP Secure.

Noprint
Section

Back To Top

Errors

CodeTextDescription
404Not FoundEither the item does not exist or has no data.
406Not AcceptableThe Request Header is not acceptable. Please see section Request Header.
500Server ErrorSomething went terribly wrong. An error message will provide a meaningful description.
Noprint
Section

Back To Top

Samples

Request 1

Code Block
languagetext
GET /items/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF/edm?oauth_consumer_key=abcdefgh12345678 HTTP/1.1
Host: api.deutsche-digitale-bibliothek.de
Accept: application/xml

Response

Noprint
Code Block
titleXML
linenumberstrue
languagexml
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<edm xmlns="http://www.deutsche-digitale-bibliothek.de/cortex"
  xmlns:ns2="http://www.deutsche-digitale-bibliothek.de/institution"
  xmlns:ns3="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:ns4="http://www.deutsche-digitale-bibliothek.de/item">
  <ns3:RDF>
    <ore:Aggregation xmlns:ore="http://www.openarchives.org/ore/terms/" ns3:about="http://d-nb.info/1003104487">
      <edm:aggregatedCHO xmlns:edm="http://www.europeana.eu/schemas/edm/"
        ns3:resource="http://www.deutsche-digitale-bibliothek.de/item/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF"/>
      <edm:dataProvider xmlns:edm="http://www.europeana.eu/schemas/edm/">Deutsche Nationalbibliothek</edm:dataProvider>
      <edm:dataProvider xmlns:edm="http://www.europeana.eu/schemas/edm/"
        ns3:resource="http://ld.zdb-services.de/data/organisations/DE-101"/>
      <edm:isShownAt xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:resource="http://d-nb.info/#1003104487_DE-101"/>
      <edm:isShownBy xmlns:edm="http://www.europeana.eu/schemas/edm/"
        ns3:resource="http://nbn-resolving.de/urn:nbn:de:101:2-2010060101"/>
      <edm:provider xmlns:edm="http://www.europeana.eu/schemas/edm/">Deutsche Digitale Bibliothek</edm:provider>
      <edm:rights xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:resource="http://www.europeana.eu/rights/rr-f"/>
      <dcterms:rights xmlns:dcterms="http://purl.org/dc/terms/"
        ns3:resource="http://creativecommons.org/publicdomain/zero/1.0/"/>
    </ore:Aggregation>
    <edm:Agent xmlns:edm="http://www.europeana.eu/schemas/edm/"
      ns3:about="http://ld.zdb-services.de/data/organisations/DE-101">
      <skos:prefLabel xmlns:skos="http://www.w3.org/2004/02/skos/core#">Deutsche Nationalbibliothek</skos:prefLabel>
      <ns3:type ns3:resource="http://ddb.vocnet.org/sparte/sparte002"/>
    </edm:Agent>
    <skos:Concept xmlns:skos="http://www.w3.org/2004/02/skos/core#" ns3:about="http://ddb.vocnet.org/sparte/sparte002">
      <skos:notation>sec_02</skos:notation>
    </skos:Concept>
    <edm:WebResource xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:about="http://d-nb.info/#1003104487_DE-101">
      <edm:rights ns3:resource="http://www.europeana.eu/rights/rr-f/"/>
      <dc:type xmlns:dc="http://purl.org/dc/elements/1.1/" ns3:resource="http://ddb.vocnet.org/medientyp/mt003"/>
      <dcterms:rights xmlns:dcterms="http://purl.org/dc/terms/"
        ns3:resource="http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/"/>
    </edm:WebResource>
    <skos:Concept xmlns:skos="http://www.w3.org/2004/02/skos/core#" ns3:about="http://ddb.vocnet.org/medientyp/mt003">
      <skos:notation>mediatype_003</skos:notation>
    </skos:Concept>
    <edm:ProvidedCHO xmlns:edm="http://www.europeana.eu/schemas/edm/"
      ns3:about="http://www.deutsche-digitale-bibliothek.de/item/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF">
      <edm:hasMet ns3:resource="FZN5H2J2GKMF7PJYCQUZ6TBNJHUXA3KG"/>
      <edm:hasMet ns3:resource="VYPN26ERGXAJADHOZIVO33VCRQ5EWGSW"/>
      <edm:hasType ns3:resource="GYHIZEVVGRVR5HQGZK6QIN3XRO3WAMKQ"/>
      <dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Goethe, Johann Wolfgang ?von?</dc:creator>
      <dc:identifier xmlns:dc="http://purl.org/dc/elements/1.1/"
        >http://nbn-resolving.de/urn:nbn:de:101:2-2010060101</dc:identifier>
      <dc:identifier xmlns:dc="http://purl.org/dc/elements/1.1/">(DE-599)DNB1003104487</dc:identifier>
      <dc:language xmlns:dc="http://purl.org/dc/elements/1.1/">ger</dc:language>
      <dc:publisher xmlns:dc="http://purl.org/dc/elements/1.1/">Scho?ningh</dc:publisher>
      <dc:type xmlns:dc="http://purl.org/dc/elements/1.1/">Monografie</dc:type>
      <dc:subject xmlns:dc="http://purl.org/dc/elements/1.1/">Deutsche Literatur</dc:subject>
      <dc:subject xmlns:dc="http://purl.org/dc/elements/1.1/">Belletristik</dc:subject>
      <dc:title xmlns:dc="http://purl.org/dc/elements/1.1/">Egmont :ein Trauerspiel in fu?nf Aufzu?gen</dc:title>
      <dcterms:language xmlns:dcterms="http://purl.org/dc/terms/"
        ns3:resource="http://id.loc.gov/vocabulary/iso639-2/ger"/>
      <dcterms:subject xmlns:dcterms="http://purl.org/dc/terms/" ns3:resource="http://d-nb.info/ddc-sg/830"/>
      <dcterms:subject xmlns:dcterms="http://purl.org/dc/terms/" ns3:resource="http://d-nb.info/ddc-sg/B"/>
      <dcterms:extent xmlns:dcterms="http://purl.org/dc/terms/">92 S.</dcterms:extent>
      <dcterms:issued xmlns:dcterms="http://purl.org/dc/terms/">1946, [1946]</dcterms:issued>
      <dcterms:bibliographicCitation xmlns:dcterms="http://purl.org/dc/terms/">Ferdinand Scho?ninghs Textausgaben alter
        und neuer Schriftsteller; 13</dcterms:bibliographicCitation>
      <edm:type>TEXT</edm:type>
      <ddb:hierarchyType xmlns:ddb="http://www.deutsche-digitale-bibliothek.de/edm/">htype_021</ddb:hierarchyType>
      <ddb:aggregationEntity xmlns:ddb="http://www.deutsche-digitale-bibliothek.de/edm/">false</ddb:aggregationEntity>
      <ddb:hierarchyPosition xmlns:ddb="http://www.deutsche-digitale-bibliothek.de/edm/">13</ddb:hierarchyPosition>
      <dcterms:isPartOf xmlns:dcterms="http://purl.org/dc/terms/">Scho?ninghs Textausgaben</dcterms:isPartOf>
      <dcterms:isPartOf xmlns:dcterms="http://purl.org/dc/terms/"
        ns3:resource="http://www.deutsche-digitale-bibliothek.de/item/IWOE72T2J3MNATFBPFV3PI3JQ3S3UXEL"/>
      <dcterms:isPartOf xmlns:dcterms="http://purl.org/dc/terms/" ns3:resource="http://d-nb.info/015656187"/>
    </edm:ProvidedCHO>
    <skos:Concept xmlns:skos="http://www.w3.org/2004/02/skos/core#" ns3:about="GYHIZEVVGRVR5HQGZK6QIN3XRO3WAMKQ">
      <skos:prefLabel>Monografie</skos:prefLabel>
    </skos:Concept>
    <skos:Concept xmlns:skos="http://www.w3.org/2004/02/skos/core#" ns3:about="http://d-nb.info/ddc-sg/830">
      <skos:prefLabel>Deutsche Literatur</skos:prefLabel>
    </skos:Concept>
    <skos:Concept xmlns:skos="http://www.w3.org/2004/02/skos/core#" ns3:about="http://d-nb.info/ddc-sg/B">
      <skos:prefLabel>Belletristik</skos:prefLabel>
    </skos:Concept>
    <dcterms:LinguisticSystem xmlns:dcterms="http://purl.org/dc/terms/"
      ns3:about="http://id.loc.gov/vocabulary/iso639-2/ger">
      <ns3:value>ger</ns3:value>
    </dcterms:LinguisticSystem>
    <edm:Event xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:about="FZN5H2J2GKMF7PJYCQUZ6TBNJHUXA3KG">
      <edm:hasType ns3:resource="http://terminology.lido-schema.org/lido00228"/>
      <crm:P11_had_participant xmlns:crm="http://www.cidoc-crm.org/rdfs/cidoc_crm_v5.0.2_english_label.rdfs#"
        ns3:resource="MR4UEARY4WRK4W7ZJKZCTBESEVLAD36F"/>
      <edm:happenedAt ns3:resource="XVEQAO74CY5FYE6FSECCY5FSSOYNXO2P"/>
      <edm:occuredAt ns3:resource="http://ddb.vocnet.org/zeitvokabular/dat00004"/>
      <edm:occuredAt ns3:resource="http://ddb.vocnet.org/zeitvokabular/dat00009"/>
      <edm:occuredAt ns3:resource="NH6ZO5WG65K3V7UHSPXQBHPQBH2OVV76"/>
    </edm:Event>
    <edm:Agent xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:about="MR4UEARY4WRK4W7ZJKZCTBESEVLAD36F">
      <skos:prefLabel xmlns:skos="http://www.w3.org/2004/02/skos/core#">Scho?ningh</skos:prefLabel>
      <edm:wasPresentAt ns3:resource="FZN5H2J2GKMF7PJYCQUZ6TBNJHUXA3KG"/>
    </edm:Agent>
    <edm:Place xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:about="XVEQAO74CY5FYE6FSECCY5FSSOYNXO2P">
      <skos:prefLabel xmlns:skos="http://www.w3.org/2004/02/skos/core#">Paderborn</skos:prefLabel>
    </edm:Place>
    <edm:TimeSpan xmlns:edm="http://www.europeana.eu/schemas/edm/"
      ns3:about="http://ddb.vocnet.org/zeitvokabular/dat00004">
      <skos:notation xmlns:skos="http://www.w3.org/2004/02/skos/core#">time_62000</skos:notation>
    </edm:TimeSpan>
    <edm:TimeSpan xmlns:edm="http://www.europeana.eu/schemas/edm/"
      ns3:about="http://ddb.vocnet.org/zeitvokabular/dat00009">
      <skos:notation xmlns:skos="http://www.w3.org/2004/02/skos/core#">time_62050</skos:notation>
    </edm:TimeSpan>
    <edm:TimeSpan xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:about="NH6ZO5WG65K3V7UHSPXQBHPQBH2OVV76">
      <edm:begin>1946, [1946]</edm:begin>
      <edm:end>1946, [1946]</edm:end>
    </edm:TimeSpan>
    <edm:Event xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:about="VYPN26ERGXAJADHOZIVO33VCRQ5EWGSW">
      <edm:hasType ns3:resource="http://terminology.lido-schema.org/lido00012"/>
      <crm:P11_had_participant xmlns:crm="http://www.cidoc-crm.org/rdfs/cidoc_crm_v5.0.2_english_label.rdfs#"
        ns3:resource="http://d-nb.info/gnd/118540238"/>
    </edm:Event>
    <edm:Agent xmlns:edm="http://www.europeana.eu/schemas/edm/" ns3:about="http://d-nb.info/gnd/118540238">
      <skos:prefLabel xmlns:skos="http://www.w3.org/2004/02/skos/core#">Goethe, Johann Wolfgang ?von?
        (1749-1832)</skos:prefLabel>
      <edm:wasPresentAt ns3:resource="VYPN26ERGXAJADHOZIVO33VCRQ5EWGSW"/>
    </edm:Agent>
  </ns3:RDF>
</edm>

 

Request 2

Code Block
languagetext
GET /items/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF/edm HTTP/1.1
Host: api.deutsche-digitale-bibliothek.de
Accept: */*
Authorization: OAuth oauth_consumer_key="abcdefgh12345678"

Response

Noprint
Code Block
titleJSON
linenumberstrue
languagejs
collapsetrue
{
   "RDF":{
      "Aggregation":{
         "@about":"http://d-nb.info/1003104487",
         "aggregatedCHO":{
            "@resource":"http://www.deutsche-digitale-bibliothek.de/item/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF"
         },
         "dataProvider":[
            "Deutsche Nationalbibliothek",
            {
               "@resource":"http://ld.zdb-services.de/data/organisations/DE-101"
            }
         ],
         "isShownAt":{
            "@resource":"http://d-nb.info/#1003104487_DE-101"
         },
         "isShownBy":{
            "@resource":"http://nbn-resolving.de/urn:nbn:de:101:2-2010060101"
         },
         "provider":"Deutsche Digitale Bibliothek",
         "rights":[
            {
               "@resource":"http://www.europeana.eu/rights/rr-f"
            },
            {
               "@resource":"http://creativecommons.org/publicdomain/zero/1.0/"
            }
         ],
         "$":"\n      "
      },
      "Agent":{
         "@about":"http://ld.zdb-services.de/data/organisations/DE-101",
         "prefLabel":"Deutsche Nationalbibliothek",
         "type":{
            "@resource":"http://ddb.vocnet.org/sparte/sparte002"
         },
         "$":"\n      "
      },
      "Concept":{
         "@about":"http://ddb.vocnet.org/sparte/sparte002",
         "notation":"sec_02",
         "$":"\n      "
      },
      "WebResource":{
         "@about":"http://d-nb.info/#1003104487_DE-101",
         "rights":{
            "@resource":"http://www.europeana.eu/rights/rr-f/"
         },
         "type":{
            "@resource":"http://ddb.vocnet.org/medientyp/mt003"
         },
         "rights":{
            "@resource":"http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/"
         },
         "$":"\n      "
      },
      "Concept":{
         "@about":"http://ddb.vocnet.org/medientyp/mt003",
         "notation":"mediatype_003",
         "$":"\n      "
      },
      "ProvidedCHO":{
         "@about":"http://www.deutsche-digitale-bibliothek.de/item/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF",
         "hasMet":[
            {
               "@resource":"FZN5H2J2GKMF7PJYCQUZ6TBNJHUXA3KG"
            },
            {
               "@resource":"VYPN26ERGXAJADHOZIVO33VCRQ5EWGSW"
            }
         ],
         "hasType":{
            "@resource":"GYHIZEVVGRVR5HQGZK6QIN3XRO3WAMKQ"
         },
         "creator":"Goethe, Johann Wolfgang ?von?",
         "identifier":[
            "http://nbn-resolving.de/urn:nbn:de:101:2-2010060101",
            "(DE-599)DNB1003104487"
         ],
         "language":"ger",
         "publisher":"Scho?ningh",
         "type":"Monografie",
         "subject":[
            "Deutsche Literatur",
            "Belletristik"
         ],
         "title":"Egmont :ein Trauerspiel in fu?nf Aufzu?gen",
         "language":{
            "@resource":"http://id.loc.gov/vocabulary/iso639-2/ger"
         },
         "subject":[
            {
               "@resource":"http://d-nb.info/ddc-sg/830"
            },
            {
               "@resource":"http://d-nb.info/ddc-sg/B"
            }
         ],
         "extent":"92 S.",
         "issued":"1946, [1946]",
         "bibliographicCitation":"Ferdinand Scho?ninghs Textausgaben alter und neuer Schriftsteller; 13",
         "type":"TEXT",
         "hierarchyType":"htype_021",
         "aggregationEntity":"false",
         "hierarchyPosition":"13",
         "isPartOf":[
            "Scho?ninghs Textausgaben",
            {
               "@resource":"http://www.deutsche-digitale-bibliothek.de/item/IWOE72T2J3MNATFBPFV3PI3JQ3S3UXEL"
            },
            {
               "@resource":"http://d-nb.info/015656187"
            }
         ],
         "$":"\n      "
      },
      "Concept":[
         {
            "@about":"GYHIZEVVGRVR5HQGZK6QIN3XRO3WAMKQ",
            "prefLabel":"Monografie",
            "$":"\n      "
         },
         {
            "@about":"http://d-nb.info/ddc-sg/830",
            "prefLabel":"Deutsche Literatur",
            "$":"\n      "
         },
         {
            "@about":"http://d-nb.info/ddc-sg/B",
            "prefLabel":"Belletristik",
            "$":"\n      "
         }
      ],
      "LinguisticSystem":{
         "@about":"http://id.loc.gov/vocabulary/iso639-2/ger",
         "value":"ger",
         "$":"\n      "
      },
      "Event":{
         "@about":"FZN5H2J2GKMF7PJYCQUZ6TBNJHUXA3KG",
         "hasType":{
            "@resource":"http://terminology.lido-schema.org/lido00228"
         },
         "P11_had_participant":{
            "@resource":"MR4UEARY4WRK4W7ZJKZCTBESEVLAD36F"
         },
         "happenedAt":{
            "@resource":"XVEQAO74CY5FYE6FSECCY5FSSOYNXO2P"
         },
         "occuredAt":[
            {
               "@resource":"http://ddb.vocnet.org/zeitvokabular/dat00004"
            },
            {
               "@resource":"http://ddb.vocnet.org/zeitvokabular/dat00009"
            },
            {
               "@resource":"NH6ZO5WG65K3V7UHSPXQBHPQBH2OVV76"
            }
         ],
         "$":"\n      "
      },
      "Agent":{
         "@about":"MR4UEARY4WRK4W7ZJKZCTBESEVLAD36F",
         "prefLabel":"Scho?ningh",
         "wasPresentAt":{
            "@resource":"FZN5H2J2GKMF7PJYCQUZ6TBNJHUXA3KG"
         },
         "$":"\n      "
      },
      "Place":{
         "@about":"XVEQAO74CY5FYE6FSECCY5FSSOYNXO2P",
         "prefLabel":"Paderborn",
         "$":"\n      "
      },
      "TimeSpan":[
         {
            "@about":"http://ddb.vocnet.org/zeitvokabular/dat00004",
            "notation":"time_62000",
            "$":"\n      "
         },
         {
            "@about":"http://ddb.vocnet.org/zeitvokabular/dat00009",
            "notation":"time_62050",
            "$":"\n      "
         },
         {
            "@about":"NH6ZO5WG65K3V7UHSPXQBHPQBH2OVV76",
            "begin":"1946, [1946]",
            "end":"1946, [1946]",
            "$":"\n      "
         }
      ],
      "Event":{
         "@about":"VYPN26ERGXAJADHOZIVO33VCRQ5EWGSW",
         "hasType":{
            "@resource":"http://terminology.lido-schema.org/lido00012"
         },
         "P11_had_participant":{
            "@resource":"http://d-nb.info/gnd/118540238"
         },
         "$":"\n      "
      },
      "Agent":{
         "@about":"http://d-nb.info/gnd/118540238",
         "prefLabel":"Goethe, Johann Wolfgang ?von? (1749-1832)",
         "wasPresentAt":{
            "@resource":"VYPN26ERGXAJADHOZIVO33VCRQ5EWGSW"
         },
         "$":"\n      "
      },
      "$":"\n    "
   }
}
Noprint
Section

Back To Top