Versions Compared

Key

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

...

NameValue(s)RequiredRepeatableDefault valueDescription
Acceptapplication/octet-stream
*/*
yesnoapplication/octet-streamSpecifies the format of the accepted data. In any case application/octet-stream will be delivered.
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.
binaryPathFile<path/filename>yesnoThe relative path and the filename of a binary file separated by slashes.
The path and filename can be retrieved via the method binaries.
Noprint
Section

Back To Top

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
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

Code Block
languagetext
GET /binary/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF/mvpr/18b03ab43-357e-42eb-8f81-b5db5ab0f2ef.jpg?oauth_consumer_key=abcdefgh12345678 HTTP/1.1
Host: api.deutsche-digitale-bibliothek.de
Accept: application/octet-stream

...

Code Block
languagetext
GET /binary/OAXO2AGT7YH35YYHN3YKBXJMEI77W3FF/mvpr/1.jpg8b03ab43-357e-42eb-8f81-b5db5ab0f2ef HTTP/1.1
Host: api.deutsche-digitale-bibliothek.de
Accept: */*
Authorization: OAuth oauth_consumer_key="abcdefgh12345678"

...