Description

The method view returns the view of an item for a given item-ID. A view is the data set a frontend page at DDB is based on. 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.
GET /items/<PathParameters>/view?<QueryParameters> HTTP/1.1

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.

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.

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.

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/view?oauth_consumer_key=abcdefgh12345678 HTTP/1.1
Host: api.deutsche-digitale-bibliothek.de
Accept: application/xml

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns4:view xmlns="http://www.deutsche-digitale-bibliothek.de/institution"
  xmlns:ns2="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:ns3="http://www.deutsche-digitale-bibliothek.de/item"
  xmlns:ns4="http://www.deutsche-digitale-bibliothek.de/cortex">
  <ns3:item>
    <ns3:identifier>1003104487</ns3:identifier>
    <ns3:label>Egmont : ein Trauerspiel in fu?nf Aufzu?gen</ns3:label>
    <ns3:title>Egmont : ein Trauerspiel in fu?nf Aufzu?gen</ns3:title>
    <ns3:subtitle>Goethe, Johann Wolfgang ?von?. - Paderborn : Scho?ningh, 1946, [1946]</ns3:subtitle>
    <ns3:rights/>
    <ns3:metadata-rights>http://creativecommons.org/publicdomain/zero/1.0/</ns3:metadata-rights>
    <ns3:origin>https://portal.dnb.de/bookviewer/view/1003104487</ns3:origin>
    <ns3:category>Kultur</ns3:category>
    <ns3:media>text</ns3:media>
    <ns3:thumbnail/>
    <ns3:latitude/>
    <ns3:longitude/>
    <ns3:viewers/>
    <ns3:license ns2:resource="http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/"
      img="http://content.deutsche-digitale-bibliothek.de/license-icons/copyright.large.png"
      url="http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/">Rechte vorbehalten – Freier Zugang</ns3:license>
    <ns3:institution>
      <ns3:url>http://www.dnb.de</ns3:url>
      <ns3:id>2Q37XY5KXJNJE5MV6SWP3UKKZ6RSBLK5</ns3:id>
      <ns3:name>Deutsche Nationalbibliothek</ns3:name>
      <ns3:logo>http://content.deutsche-digitale-bibliothek.de/binaries/institution-institutionen/20120720/edit/00012008/dnb_RGB.jpg</ns3:logo>
    </ns3:institution>
    <ns3:fields usage="display">
      <ns3:field id="flex_bibl_002">
        <ns3:name>Beteiligte Personen und Organisationen</ns3:name>
        <ns3:value ns2:resource="http://d-nb.info/gnd/118540238">Goethe, Johann Wolfgang ?von? (1749-1832)</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_003">
        <ns3:name>Dokumenttyp</ns3:name>
        <ns3:value>Monografie</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_006">
        <ns3:name>Erschienen</ns3:name>
        <ns3:value>Paderborn : Scho?ningh, 1946, [1946]</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_006">
        <ns3:name>Erschienen</ns3:name>
        <ns3:value>[Online-Ausg.]: 2010</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_008">
        <ns3:name>Sprache</ns3:name>
        <ns3:value>Deutsch</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_009">
        <ns3:name>Umfang</ns3:name>
        <ns3:value>92 S.</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_010">
        <ns3:name>Reihe</ns3:name>
        <ns3:value>Ferdinand Scho?ninghs Textausgaben alter und neuer Schriftsteller ; 13</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_011">
        <ns3:name>Thema</ns3:name>
        <ns3:value>Deutsche Literatur</ns3:value>
      </ns3:field>
      <ns3:field id="NON_NLS_1">
        <ns3:name>Link zum Katalogisat/OPAC</ns3:name>
        <ns3:value>http://d-nb.info/1003104487</ns3:value>
      </ns3:field>
      <ns3:field id="flex_bibl_013b">
        <ns3:name>URN</ns3:name>
        <ns3:value>http://nbn-resolving.de/urn:nbn:de:101:2-2010060101</ns3:value>
      </ns3:field>
    </ns3:fields>
    <ns3:fields usage="index">
      <ns3:field ns2:resource="http://purl.org/dc/elements/1.1/title" id="title">
        <ns3:name>Title</ns3:name>
        <ns3:value>Egmont : ein Trauerspiel in fu?nf Aufzu?gen</ns3:value>
      </ns3:field>
      <ns3:field ns2:resource="http://purl.org/dc/elements/1.1/description" id="description">
        <ns3:name>Beschreibung</ns3:name>
        <ns3:value>Deutsche Literatur</ns3:value>
      </ns3:field>
      <ns3:field id="ranking">
        <ns3:name>Ranking</ns3:name>
        <ns3:value>Deutsche Literatur</ns3:value>
        <ns3:value>Goethe, Johann Wolfgang ?von?</ns3:value>
      </ns3:field>
      <ns3:field id="license">
        <ns3:name>Lizenz</ns3:name>
        <ns3:value>http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/</ns3:value>
      </ns3:field>
      <ns3:field id="grid_preview">
        <ns3:name>grid_preview</ns3:name>
        <ns3:value>true</ns3:value>
      </ns3:field>
      <ns3:field id="digitalisat">
        <ns3:name>digitalisat</ns3:name>
        <ns3:value>true</ns3:value>
      </ns3:field>
      <ns3:field id="begin_time">
        <ns3:name>Anfang</ns3:name>
        <ns3:value>710398</ns3:value>
      </ns3:field>
      <ns3:field id="end_time">
        <ns3:name>Ende</ns3:name>
        <ns3:value>710762</ns3:value>
      </ns3:field>
    </ns3:fields>
  </ns3:item>
</ns4:view>

 

Request 2

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

Response

{
   "item":{
      "identifier":"1003104487",
      "label":"Egmont : ein Trauerspiel in fu?nf Aufzu?gen",
      "title":"Egmont : ein Trauerspiel in fu?nf Aufzu?gen",
      "subtitle":"Goethe, Johann Wolfgang ?von?. - Paderborn : Scho?ningh, 1946, [1946]",
      "rights":"",
      "metadata-rights":"http://creativecommons.org/publicdomain/zero/1.0/",
      "origin":"https://portal.dnb.de/bookviewer/view/1003104487",
      "category":"Kultur",
      "media":"text",
      "thumbnail":"",
      "latitude":"",
      "longitude":"",
      "viewers":null,
      "license":{
         "@resource":"http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/",
         "@img":"http://content.deutsche-digitale-bibliothek.de/license-icons/copyright.large.png",
         "@url":"http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/",
         "$":"Rechte vorbehalten – Freier Zugang"
      },
      "institution":{
         "url":"http://www.dnb.de",
         "id":"2Q37XY5KXJNJE5MV6SWP3UKKZ6RSBLK5",
         "name":"Deutsche Nationalbibliothek",
         "logo":"http://content.deutsche-digitale-bibliothek.de/binaries/institution-institutionen/20120720/edit/00012008/dnb_RGB.jpg"
      },
      "fields":[
         {
            "@usage":"display",
            "field":[
               {
                  "@id":"flex_bibl_002",
                  "name":"Beteiligte Personen und Organisationen",
                  "value":{
                     "@resource":"http://d-nb.info/gnd/118540238",
                     "$":"Goethe, Johann Wolfgang ?von? (1749-1832)"
                  }
               },
               {
                  "@id":"flex_bibl_003",
                  "name":"Dokumenttyp",
                  "value":"Monografie"
               },
               {
                  "@id":"flex_bibl_006",
                  "name":"Erschienen",
                  "value":"Paderborn : Scho?ningh, 1946, [1946]"
               },
               {
                  "@id":"flex_bibl_006",
                  "name":"Erschienen",
                  "value":"[Online-Ausg.]: 2010"
               },
               {
                  "@id":"flex_bibl_008",
                  "name":"Sprache",
                  "value":"Deutsch"
               },
               {
                  "@id":"flex_bibl_009",
                  "name":"Umfang",
                  "value":"92 S."
               },
               {
                  "@id":"flex_bibl_010",
                  "name":"Reihe",
                  "value":"Ferdinand Scho?ninghs Textausgaben alter und neuer Schriftsteller ; 13"
               },
               {
                  "@id":"flex_bibl_011",
                  "name":"Thema",
                  "value":"Deutsche Literatur"
               },
               {
                  "@id":"NON_NLS_1",
                  "name":"Link zum Katalogisat/OPAC",
                  "value":"http://d-nb.info/1003104487"
               },
               {
                  "@id":"flex_bibl_013b",
                  "name":"URN",
                  "value":"http://nbn-resolving.de/urn:nbn:de:101:2-2010060101"
               }
            ]
         },
         {
            "@usage":"index",
            "field":[
               {
                  "@resource":"http://purl.org/dc/elements/1.1/title",
                  "@id":"title",
                  "name":"Title",
                  "value":"Egmont : ein Trauerspiel in fu?nf Aufzu?gen"
               },
               {
                  "@resource":"http://purl.org/dc/elements/1.1/description",
                  "@id":"description",
                  "name":"Beschreibung",
                  "value":"Deutsche Literatur"
               },
               {
                  "@id":"ranking",
                  "name":"Ranking",
                  "value":[
                     "Deutsche Literatur",
                     "Goethe, Johann Wolfgang ?von?"
                  ]
               },
               {
                  "@id":"license",
                  "name":"Lizenz",
                  "value":"http://www.deutsche-digitale-bibliothek.de/lizenzen/rv-fz/"
               },
               {
                  "@id":"grid_preview",
                  "name":"grid_preview",
                  "value":"true"
               },
               {
                  "@id":"digitalisat",
                  "name":"digitalisat",
                  "value":"true"
               },
               {
                  "@id":"begin_time",
                  "name":"Anfang",
                  "value":"710398"
               },
               {
                  "@id":"end_time",
                  "name":"Ende",
                  "value":"710762"
               }
            ]
         }
      ]
   }
}

Back To Top