LIB Collection API for Museum Koenig Bonn

Web service for accessing the natural history collections data in the digital catalog of LIB.
It is possible to search in the Specimens and Collections.

Results are avaliable in HTML, JSON or XML/RDF format. Various parameters can be used to scroll through the results, request a specific format or set the page size.

• Access to Specimens: https://id.zfmk.de/collection_ZFMK
• Access to Collections: https://id.zfmk.de/collection_ZFMK/collection

Home  ·  Terms of service  ·  Contact the developer  ·  License: Apache 2.0

Searching

Collection entry:

• /collection_ZFMK/collection/: list of the collections: https://id.zfmk.de/collection_ZFMK/collection/

Collection Specimen:

Each search parameter is an approximate search for the word. Thus the text accessionnumber=HERP finds all entries in which the catalog number begins with MAM.

• /collection_ZFMK: list of all accessible specimens in the catalog: https://id.zfmk.de/collection_ZFMK
• /collection_ZFMK?taxonname=<name of a taxon or species>: search for taxon name or species name in catalog.
  Example: https://id.zfmk.de/collection_ZFMK?taxonname=Lepidoptera
• /collection_ZFMK?project=<project name>: search for all entries from a given project.
  Example: https://id.zfmk.de/collection_ZFMK?project=GBOL

Detailed information for one entry

Collection entry:

• /collection_ZFMK/collection/<collection id> details of one collection entry from a given collection id.
  Example: https://id.zfmk.de/collection_ZFMK/collection/10960

Collection Specimen:

• /collection_ZFMK?accessionnumber=<catalog number>: details of one collection specimen entry from a given catalog number.
  Example: https://id.zfmk.de/collection_ZFMK?accessionnumber=MAM1930-0010
• /collection_ZFMK/<specimen id>: details of one collection specimen entry from a given specimen id. Please note: the specimen id is part of the url path, not a parameter.
  Example: https://id.zfmk.de/collection_ZFMK/10018467
• /collection_ZFMK/<specimen id>/<unit id>/<part id>: details of one specimen part entry from a given specimen id.
  Example: https://id.zfmk.de/collection_ZFMK/224097695/1167587/340536

Paging query parameters

• page=<page number>: jump to a page in the result list.
  Example: https://id.zfmk.de/collection_ZFMK?page=3
• pagesize=<number>: set the pagesize, i.e. the number of entries schon on each page (default: 100).
  Example: https://id.zfmk.de/collection_ZFMK?pagesize=10

Data format

The data format of the server response can be passed either as query parameter, as URL path or via content negotiation.
Possible formats are: html, json and xml/rdf.
The described parameters for browsing and searching for taxon names and projects are possible, as well as the URL path extensions for the detailed display of an entry from the catalog.

Format parameter

• format=<json|html|rdf>: returns the result in the specified format.
  Example: https://id.zfmk.de/collection_ZFMK?format=json

Format url path

• /json/: returns the result in json format.
  Example: https://id.zfmk.de/collection_ZFMK/json?project=GBOL&page=3
• /html/: returns the result in html format (default). Parameters for paging, and search for taxon names and projects are possible.
  Example: https://id.zfmk.de/collection_ZFMK/html?taxonname=Coleoptera&page=11
• /rdf/xml/: returns the result in rdf format. Parameters for paging, and search for taxon names and projects are possible. The data format rdf works only for single entries.
  Example: https://id.zfmk.de/collection_ZFMK/rdf/xml/224097695/1167587/340536