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, to retrieve the next records of an incomplete list. | An exclusive argument with a value returned by the previous ListRecords, to retrieve the next records of an incomplete list. |
Example queries:
What data sets does the TIB provide?
Static Sets
The TIB provides its own static sets which correspond to data deliverer. The list of our static sets can be retrieved via the following URL:
https://www.tib.eu/oai/public/repository/open?verb=ListSets
Dynamic Sets
The TIB offers a special syntax for Sets we call “Dynamic Sets”. By this special syntax it is possible to create more complex queries for the service provider.
The syntax for dynamic Set names can be seen in the following template:
collection~<set>_solr~<search>
The following components of the Set names must be included:
| Parameter | Description |
|---|---|
| set | One normal set name (e.g. “tibkat”) or for all records use “all” or “*” |
| search | Search query. The syntax corresponds to the syntax of the TIB Portal ( www.tib.eu ). |
Example queries:
If you want to search for all records matching the term “laser” the set name would be the following: collection~*_solr~laser
General information of the TIB OAI server
| Information | Readings |
|---|---|
| Number of the delivered records per answer | 100 records |
| Time specification | time specified in Coordinated Universal Time UTC |
| Period for the selective Harvesting | days accuracy (YYYY-MM-DD) |
| Deleted records | Deleted Record Policy: no |
| Format | Standard: Dublin Core |
| Sets | ListSets |
| Encoding | As mentioned below formats are offered in the UTF-8coding! |
Format
The following formats can be in principal requested from our OAI interface. Only the ones marked with “for all users” are accessible to every user. If you required one the other formats please make an inquiry to our customer service.
| Format | Availability | Description |
|---|---|---|
| oai_dc | for all users | Dublin Core, free format |
| dcx | on inquiry | Dublin Core Extension |
| bibtex | on inquiry | BibTex |
| datacite | on inquiry | Datacite Format |
| on inquiry | Linked Open Data (LOD) | |
| marc_xml | for all users | Marc-21-Xml |
| rdf_xml | for all users | RDF_XML |
| ris | on inquiry | Research Information System Format |
| ftx | on inquiry | TIB internal format |
Example queries:
https://www.tib.eu/oai/public/repository/open?verb=ListRecords&metadataPrefix=oai_dc
OAI endpoint
The following OAI endpoints are public and can be used by all users:
| endpoint | content | format |
|---|---|---|
| https://www.tib.eu/oai/public/repository/open | All open access documents in the TIB Portal | oai_dc marc_xml rdf_xml |