Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning
titleDeprecated

The documentation of this API method is deprecated.

Section
Column

Description

Excerpt
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.
Code Block
languagetext
GET /items/<PathParameters>/source?<QueryParameters> HTTP/1.1
Column
width30%
Noprint
Panel
titleContent of this page

Table of Contents
maxLevel2

...

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.
Noprint
Section

Back To Top

Parameters

Path

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

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.

Noprint
Section

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.
Noprint
Section

Back To Top

Samples

Request 1

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

...

Noprint
Code Block
titleJSON
linenumberstrue
languagejs
collapsetrue
<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>

 

 

Noprint
Section

Back To Top