Overview
OAI-PMH(OAI-Protocol for Metadata Harvesting) provides an efficient exchange of Metadata in its own standardized OAI format so called OAI protocol. The data are provided by the internal databases (data providers). The collected records are then processed by service providers and provided for search queries. The OAI harvester is working with simple HTTP GET requests and HTTP POST. The HTTP response provides the record data from the data providers in various formats.
TIB offers a search option to their data via OAI interface.
Each user is qualified to retrieve open access documents via OAI interface from TIB. The fee-basedmetadata are only accessible to authorized users. The above mentioned metadata are made availableby the OAI interface. The metadata is provided by different content and formal criteria so-called “Sets”. These Sets can be delivered by previous mentioned procedure using internal datbase collections. The Sets are divided into two different request methods so called “static Sets” and “dynamic Sets”.
Standards of OAI interface
We offer OAI protocol OAI-PMH Version 2.0. This protocol is based on well-known and popular standards.
This documentation will only give you an basic overview of the protocol. Please consult the standard for more information.
OAI request types
There are six different OAI inquiry request types. They should be selected by the values of the URLparameter "verb".
| Function | Description |
|---|---|
| Identify | Display of general information about the repository |
| ListSets | Delivers all available standing data sets (collections) |
| ListMetadaFormats | Listing of all data formats available in the repository |
| ListIdentifiers | List of unique identifiers of records |
| ListRecords | Records of the archive |
| GetRecord | To select only one record |
Example queries:
https://www.tib.eu/oai/public/repository/open?verb=Identify
https://www.tib.eu/oai/public/repository/open?verb=ListSets
https://www.tib.eu/oai/public/repository/open?verb=ListMetadataFormats
https://www.tib.eu/oai/public/repository/open?verb=ListIdentifiers&metadataPrefix=oai_dc
https://www.tib.eu/oai/public/repository/open?verb=ListRecords&metadataPrefix=oai_dc&set=tibkat
ListRecords
As an example we cover the most important request type “ListRecords”. It supports the following arguments:
| Argument | Description | Request Example |
|---|---|---|
| metadataPrefix | a required argument. Specifies the metadata format returned. See section “Format” for the formats provides by TIB. | verb=ListRecords&metadataPrefix=oai_dc |
| from | an otional argument, which specifies a lower bound for datestamp-based | verb=ListRecords&from=2010-01-01 |
| until | an optional argument, whichh specifies a upper bound for datestamp-based | verb=ListRecords&until=2016-01-01 |
| set | an optional argument with a setSpec value, wich specifices set criteria for selective harvesting | verb=ListRecords&set=tibkat |
| resumptionToken | An exclusive argument with a value returned by the previous ListRecords, toretrieve the next records of an incomplete list. | An exclusive argument with a value returned by the previous ListRecords, toretrieve the next records of an incomplete list. |
Example queries: