Skip to content

Latest commit

 

History

History
33 lines (20 loc) · 2.14 KB

README.md

File metadata and controls

33 lines (20 loc) · 2.14 KB

GBIF Registy OAI-PMH

In addition to the RESTful JSON API, Datasets are exposed using OAI-PMH. Two metadata formats can be retrieved: Ecological Metadata Language (EML) and OAI Dublin Core. Datasets are grouped into sets according to type, country and installation.

The endpoint is at https://api.gbif.org/v1/oai-pmh/registry (production).

Full details of the protocol can be found in The Open Archives Initiative Protocol for Metadata Harvesting, in particular the section on Protocol Requests and, Responses.

Example queries

  • Retrieve information about the OAI-PMH service: Identify.

  • Retrieve a list of available sets (dataset types, countries and serving installations): ListSets. Sets have names like dataset_type:CHECKLIST and country:NL.

  • Retrieve the identifiers for all datasets from a particular installation: ListIdentifiers. According to the OAI-PMH protocol, metadataPrefix must be set to either oai_dc or eml, even though both formats are supported for all datasets.

  • Retrieve the metadata for all datasets served by installations in a country: ListRecords. Country codes are based on the ISO 3166-1 standard. Some queries will return more than one page of results. In this case, the XML will end with a resumption token element, for example: <resumptionToken cursor="1">MToxMDB8Mjpjb3VudHJ5Ok5MfDM6fDQ6fDU6b2FpX2Rj</resumptionToken> The second page of results can be retrieved like this: Resume.

Configuration

Properties can be configured

Parent