GBV DAIA Webservice

This is the central GBV DAIA Server to query current availability of document and exemplars in libraries and similar institutions. info

See the DAIA specification for technical details and a description of the response formats.

Request format

The basic request format is (parts in brackets must be replaced by actual values):

http://daia.gbv.de/?id={ID}&format={FORMAT} for all institutions
http://daia.gbv.de/isil/{ISIL}?id={ID}&format={FORMAT} for specific libraries

Parameters

There are up to three HTTP GET parameters:

id: a document identifier as described below
format: one of xml for DAIA/XML; json for DAIA/JSON; or turtle, rdfxml, ntriples, or rdfjson for DAIA/RDF in Turtle, RDF/XML, NTriples or RDF/JSON. Content negotiation as alternative may be added later.
callback: JSONP callback name (only for format=json and format=rdfjson)

Base URL for specific libraries

To query the availability in specific libraries you must provide an International Standard Identifier for Libraries and Related Organizations (ISIL) as part of the base URL. To check whether GBV has information about a library identified by an ISIL, see the URL http://uri.gbv.de/organization/isil/{ISIL}.

Document identifiers

Document identifier may consist of the following elements:

dbkey
: a GBV database key. By default the main catalog of a library is used as database. See http://uri.gbv.de/database/ for a full list of existing database keys. Additional databases can be added on request.
ppn
: the document record's pica production number (PPN).

The general form of an identifier is {PREFIX}{DBKEY}:ppn:{PPN} where PREFIX is http://uri.gbv.de/document/ (optional), DBKEY is a GBV database key (optional if it can be derived from the base URL).

Examples

http://uri.gbv.de/document/opac-de-830:ppn:540319058 (http://uri.gbv.de/document/{DBKEY}:ppn:{PPN})
opac-de-7:bar:7$112207197 ({DBKEY}:bar:{BARCODE} with $ as delimiter)
opac-de-hil2:ppn:16523315X ({DBKEY}:ppn:{PPN})
ppn:16523315X (ppn:{PPN} with /isil/DE-Hil2 in base URL)

DAIA validator

You can check and transform DAIA format with the DAIA validator.

Configuration

All configuration files are available at GitHub. See /config for general configuration and /isil/{ISIL}/config for full configuration of a specific library.