BookMetaHub Open API

BookMetaHub Open API

BookMetaHub – HowTo: open API

 

We are happy to announce that the BookMetaHub now operates an OAI-PMH service for the distribution of metadata in XML

This system is based on the OAI-PMH version 2 repository framework and implements the interface as documented here:

http://www.openarchives.org/OAI/openarchivesprotocol.html

We support selective harvesting according to sets defined by the Publisher’s Workspaces available on BookMetaHub. To list all available sets, go to:

https://bookmetahub.scienceopen.com/OAI/OAIHandler?verb=ListSets

 

Please note that the from and until dates in a request capture when a record was imported to OAI database and are not referring to the publishing dates of the item.

This means a request of records with dates defined e.g. 2022-01-01 to 2022-12-31 will return all records that were created or updated within the hub throughout the year of 2022, regardless of the publication dates included in the records.

 

With the ListIdentifiers (ListRecords) request the set, from, and until parameters are optional.

 

Examples of requests:

 

Request a list of records from Masaryk University Press set (Workspace):

https://bookmetahub.scienceopen.com/OAI/OAIHandler?verb=ListRecords&metadataPrefix=oai_dc&set=1e5c5811-4644-43ce-9358-112fcbb78360

Request a list of all records imported since 2022-12-01:

https://bookmetahub.scienceopen.com/OAI/OAIHandler?verb=ListRecords&metadataPrefix=oai_dc&from=2022-12-01

 

Many OAI requests are too big to be retrieved in a single transaction. If a given response contains a resumption token like this:

<resumptionToken expirationDate=”2022-12-12T12:19:04Z” completeListSize=”705″ cursor=”10″>a8f7db4c-31cf-413c-8710-e13c8d845c6f</resumptionToken>

you must make an additional request to retrieve the rest of the data. The token should be appended to the end of the next request:

https://bookmetahub.scienceopen.com/OAI/OAIHandler?verb=ListRecords&resumptionToken=f3a79924-5080-4a10-8d86-275a237d2931