The documentation of this API method is deprecated.

Description

The method source returns the initial XML metadata of an item for a given item-ID. The format can be one of the accepted input data formats (e.g. MARCXML, METS/MODS, LIDO, Dublin Core). This method provides response data only as application/xml because the DDB only accept XML-based metadata from its contributing institutions. It is a read-only service and must be accessed with a HTTP-GET-request.
GET /items/<PathParameters>/source?<QueryParameters> HTTP/1.1

Request Header

NameValue(s)RequiredRepeatableDefault valueDescription
Acceptapplication/xml
*/*
yesnoapplication/xmlSpecifies 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: */*) XML will be returned.
Hostapi.deutsche-digitale-bibliothek.deyesnoThe host is mandatory.

Back To Top

Parameters

Path

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

Back To Top

Authorization

This method needs no API key for authentication (Who are you?) or authorization (What you are authorized to do?).

This method is offered over HTTP and HTTP Secure.

Back To Top

Errors

CodeTextDescription
403
Forbidden 
Item is not available via API (items can be blacklisted because of copyright issues)
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.

Back To Top

Samples

Request 1

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

Response

<collection xmlns="http://www.loc.gov/MARC21/slim">
  <record type="Bibliographic">
    <leader>01507nam a2200373 c 4500</leader>
    <controlfield tag="001">1003104487</controlfield>
    <controlfield tag="003">DE-101</controlfield>
    <controlfield tag="005">20110503104153.0</controlfield>
    <controlfield tag="007">cr||||||||||||</controlfield>
    <controlfield tag="008">100601s1946 gw |||||o|||| 00||||ger</controlfield>
    <datafield tag="015" ind1=" " ind2=" ">
      <subfield code="a">10,O10</subfield>
      <subfield code="2">dnb</subfield>
    </datafield>
    <datafield tag="016" ind1="7" ind2=" ">
      <subfield code="2">DE-101</subfield>
      <subfield code="a">1003104487</subfield>
    </datafield>
    <datafield tag="024" ind1="7" ind2=" ">
      <subfield code="2">urn</subfield>
      <subfield code="a">urn:nbn:de:101:2-2010060101</subfield>
    </datafield>
    <datafield tag="035" ind1=" " ind2=" ">
      <subfield code="a">(DE-599)DNB1003104487</subfield>
    </datafield>
    <datafield tag="040" ind1=" " ind2=" ">
      <subfield code="a">1140</subfield>
      <subfield code="b">ger</subfield>
      <subfield code="c">DE-101</subfield>
      <subfield code="d">1141</subfield>
      <subfield code="e">rakwb</subfield>
    </datafield>
    <datafield tag="041" ind1=" " ind2=" ">
      <subfield code="a">ger</subfield>
    </datafield>
    <datafield tag="044" ind1=" " ind2=" ">
      <subfield code="c">XA-DE</subfield>
    </datafield>
    <datafield tag="082" ind1="7" ind2="4">
      <subfield code="a">830</subfield>
      <subfield code="a">B</subfield>
      <subfield code="q">DE-101</subfield>
      <subfield code="2">22sdnb</subfield>
    </datafield>
    <datafield tag="084" ind1=" " ind2=" ">
      <subfield code="a">830</subfield>
      <subfield code="a">B</subfield>
      <subfield code="q">DE-101</subfield>
      <subfield code="2">sdnb</subfield>
    </datafield>
    <datafield tag="100" ind1="1" ind2=" ">
      <subfield code="0">(DE-588)118540238</subfield>
      <subfield code="0">(DE-101)118540238</subfield>
      <subfield code="a">Goethe, Johann Wolfgang ?von?</subfield>
      <subfield code="d">1749-1832</subfield>
      <subfield code="4">aut</subfield>
    </datafield>
    <datafield tag="245" ind1="1" ind2="0">
      <subfield code="a">Egmont</subfield>
      <subfield code="h">Elektronische Ressource</subfield>
      <subfield code="b">ein Trauerspiel in fu?nf Aufzu?gen</subfield>
      <subfield code="c">J. W. von Goethe</subfield>
    </datafield>
    <datafield tag="260" ind1="3" ind2=" ">
      <subfield code="a">Paderborn</subfield>
      <subfield code="b">Scho?ningh</subfield>
      <subfield code="c">1946, [1946]</subfield>
    </datafield>
    <datafield tag="300" ind1=" " ind2=" ">
      <subfield code="a">92 S.</subfield>
    </datafield>
    <datafield tag="490" ind1="1" ind2=" ">
      <subfield code="a">Ferdinand Scho?ninghs Textausgaben alter und neuer Schriftsteller</subfield>
      <subfield code="v">13</subfield>
    </datafield>
    <datafield tag="500" ind1=" " ind2=" ">
      <subfield code="a">In Fraktur</subfield>
    </datafield>
    <datafield tag="530" ind1=" " ind2=" ">
      <subfield code="a">Online-Ausg.:</subfield>
    </datafield>
    <datafield tag="533" ind1=" " ind2=" ">
      <subfield code="7">s2010uuuu</subfield>
      <subfield code="b">Leipzig ; Frankfurt, M. ; Berlin</subfield>
      <subfield code="c">Dt. Nationalbibliothek</subfield>
      <subfield code="d">2010</subfield>
      <subfield code="e">Online-Ressource</subfield>
      <subfield code="n">[Online-Ausg.]</subfield>
    </datafield>
    <datafield tag="583" ind1="1" ind2=" ">
      <subfield code="a">Langzeitarchivierung gewa?hrleistet</subfield>
      <subfield code="i">LZA</subfield>
    </datafield>
    <datafield tag="775" ind1="0" ind2="8">
      <subfield code="i">Druckausg.</subfield>
      <subfield code="a">Goethe, Johann Wolfgang ?von?</subfield>
      <subfield code="t">Egmont</subfield>
      <subfield code="w">(DE-101)451585097</subfield>
    </datafield>
    <datafield tag="830" ind1=" " ind2="0">
      <subfield code="a">Scho?ninghs Textausgaben</subfield>
      <subfield code="v">13</subfield>
      <subfield code="w">(DE-101)015656187</subfield>
      <subfield code="w">(DE-600)1033259-5</subfield>
      <subfield code="9">213</subfield>
    </datafield>
    <datafield tag="856" ind1="4" ind2="0">
      <subfield code="u">http://nbn-resolving.de/urn:nbn:de:101:2-2010060101</subfield>
      <subfield code="x">Resolving-System</subfield>
    </datafield>
    <datafield tag="856" ind1=" " ind2="0">
      <subfield code="u">http://d-nb.info/1003104487/34</subfield>
      <subfield code="x">Langzeitarchivierung Nationalbibliothek</subfield>
    </datafield>
    <datafield tag="889" ind1=" " ind2=" ">
      <subfield code="w">(DE-101)1006091114</subfield>
    </datafield>
    <datafield tag="925" ind1="r" ind2=" ">
      <subfield code="a">ro</subfield>
      <subfield code="a">rb</subfield>
    </datafield>
  </record>
</collection>

Request 2

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

Response

<collection xmlns="http://www.loc.gov/MARC21/slim">
  <record type="Bibliographic">
    <leader>01507nam a2200373 c 4500</leader>
    <controlfield tag="001">1003104487</controlfield>
    <controlfield tag="003">DE-101</controlfield>
    <controlfield tag="005">20110503104153.0</controlfield>
    <controlfield tag="007">cr||||||||||||</controlfield>
    <controlfield tag="008">100601s1946 gw |||||o|||| 00||||ger</controlfield>
    <datafield tag="015" ind1=" " ind2=" ">
      <subfield code="a">10,O10</subfield>
      <subfield code="2">dnb</subfield>
    </datafield>
    <datafield tag="016" ind1="7" ind2=" ">
      <subfield code="2">DE-101</subfield>
      <subfield code="a">1003104487</subfield>
    </datafield>
    <datafield tag="024" ind1="7" ind2=" ">
      <subfield code="2">urn</subfield>
      <subfield code="a">urn:nbn:de:101:2-2010060101</subfield>
    </datafield>
    <datafield tag="035" ind1=" " ind2=" ">
      <subfield code="a">(DE-599)DNB1003104487</subfield>
    </datafield>
    <datafield tag="040" ind1=" " ind2=" ">
      <subfield code="a">1140</subfield>
      <subfield code="b">ger</subfield>
      <subfield code="c">DE-101</subfield>
      <subfield code="d">1141</subfield>
      <subfield code="e">rakwb</subfield>
    </datafield>
    <datafield tag="041" ind1=" " ind2=" ">
      <subfield code="a">ger</subfield>
    </datafield>
    <datafield tag="044" ind1=" " ind2=" ">
      <subfield code="c">XA-DE</subfield>
    </datafield>
    <datafield tag="082" ind1="7" ind2="4">
      <subfield code="a">830</subfield>
      <subfield code="a">B</subfield>
      <subfield code="q">DE-101</subfield>
      <subfield code="2">22sdnb</subfield>
    </datafield>
    <datafield tag="084" ind1=" " ind2=" ">
      <subfield code="a">830</subfield>
      <subfield code="a">B</subfield>
      <subfield code="q">DE-101</subfield>
      <subfield code="2">sdnb</subfield>
    </datafield>
    <datafield tag="100" ind1="1" ind2=" ">
      <subfield code="0">(DE-588)118540238</subfield>
      <subfield code="0">(DE-101)118540238</subfield>
      <subfield code="a">Goethe, Johann Wolfgang ?von?</subfield>
      <subfield code="d">1749-1832</subfield>
      <subfield code="4">aut</subfield>
    </datafield>
    <datafield tag="245" ind1="1" ind2="0">
      <subfield code="a">Egmont</subfield>
      <subfield code="h">Elektronische Ressource</subfield>
      <subfield code="b">ein Trauerspiel in fu?nf Aufzu?gen</subfield>
      <subfield code="c">J. W. von Goethe</subfield>
    </datafield>
    <datafield tag="260" ind1="3" ind2=" ">
      <subfield code="a">Paderborn</subfield>
      <subfield code="b">Scho?ningh</subfield>
      <subfield code="c">1946, [1946]</subfield>
    </datafield>
    <datafield tag="300" ind1=" " ind2=" ">
      <subfield code="a">92 S.</subfield>
    </datafield>
    <datafield tag="490" ind1="1" ind2=" ">
      <subfield code="a">Ferdinand Scho?ninghs Textausgaben alter und neuer Schriftsteller</subfield>
      <subfield code="v">13</subfield>
    </datafield>
    <datafield tag="500" ind1=" " ind2=" ">
      <subfield code="a">In Fraktur</subfield>
    </datafield>
    <datafield tag="530" ind1=" " ind2=" ">
      <subfield code="a">Online-Ausg.:</subfield>
    </datafield>
    <datafield tag="533" ind1=" " ind2=" ">
      <subfield code="7">s2010uuuu</subfield>
      <subfield code="b">Leipzig ; Frankfurt, M. ; Berlin</subfield>
      <subfield code="c">Dt. Nationalbibliothek</subfield>
      <subfield code="d">2010</subfield>
      <subfield code="e">Online-Ressource</subfield>
      <subfield code="n">[Online-Ausg.]</subfield>
    </datafield>
    <datafield tag="583" ind1="1" ind2=" ">
      <subfield code="a">Langzeitarchivierung gewa?hrleistet</subfield>
      <subfield code="i">LZA</subfield>
    </datafield>
    <datafield tag="775" ind1="0" ind2="8">
      <subfield code="i">Druckausg.</subfield>
      <subfield code="a">Goethe, Johann Wolfgang ?von?</subfield>
      <subfield code="t">Egmont</subfield>
      <subfield code="w">(DE-101)451585097</subfield>
    </datafield>
    <datafield tag="830" ind1=" " ind2="0">
      <subfield code="a">Scho?ninghs Textausgaben</subfield>
      <subfield code="v">13</subfield>
      <subfield code="w">(DE-101)015656187</subfield>
      <subfield code="w">(DE-600)1033259-5</subfield>
      <subfield code="9">213</subfield>
    </datafield>
    <datafield tag="856" ind1="4" ind2="0">
      <subfield code="u">http://nbn-resolving.de/urn:nbn:de:101:2-2010060101</subfield>
      <subfield code="x">Resolving-System</subfield>
    </datafield>
    <datafield tag="856" ind1=" " ind2="0">
      <subfield code="u">http://d-nb.info/1003104487/34</subfield>
      <subfield code="x">Langzeitarchivierung Nationalbibliothek</subfield>
    </datafield>
    <datafield tag="889" ind1=" " ind2=" ">
      <subfield code="w">(DE-101)1006091114</subfield>
    </datafield>
    <datafield tag="925" ind1="r" ind2=" ">
      <subfield code="a">ro</subfield>
      <subfield code="a">rb</subfield>
    </datafield>
  </record>
</collection>

 

 

Back To Top