Skip to end of metadata
Go to start of metadata

Deprecated

Icon

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.
Content of this page

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.

Parameters

Path

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

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.

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.

Samples

Request 1

Response

XML  Expand source

Request 2

Response

JSON  Expand source

 

 

  • No labels