| Panel | ||||
|---|---|---|---|---|
| ||||
|
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.
...
| 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
httpshttps://www.tib.eu/oai/public/repository/open?verb=ListSets
https://www.tib.eu/oai/public/repository/open?verb=ListMetadataFormats
...
| 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:
https://www.tib.eu/oai/public/repository/open?verb=ListRecords&metadataPrefix=oai_dc&from=20142020-01-01&until=20162020-08-01&set=tibkat
What data sets does the TIB provide?
...
The following OAI endpoints are public and can be used by all users:
| endpoint | set | contentpermitted | formatexample: search term 'solid' | format=oai_dc |
|---|---|---|---|
| https://www.tib.eu/oai/public/repository/open | collection~* OR collection~all | All open access documents in the TIB Portal | |
| collection~tibkat | TIBKAT | ||
| collection~olc | Online Contents | ||
| collection~kmo-av | TIB AV-Portal |
Permitted format for public entpoint 'open': oai_dc, marc_xml
...
, rdf_xml, rdf_n3, rdf_json, rdf_turtle, rdf_jsonld .
Customer specific endpoints
...
With your personal UUID you are able to query the open access documents and also the fee-based metadata you are allowed to. For more details, please contact our customer service.
How do I use my private UUID ?
As soon as you receive your UUID you are able to harvest data from the TIB in the format TIB has approved.
Your private UUID is then an integrated part of the base URL. It will the resolve the url path element “open” in all previous urls.
Example: https://www.tib.eu/oai/public/repository/XxXxXxXxXxX?verb=ListRecords&metadataPrefix=oai_dc
Special Set settings
If necessary, special sets can be configured for customers to retrieve the agreed records.
The customer can request up to five different special sets, which will be configured by our customer service. They are normally names “all1” to “all5”.
For each special set it is possible to combine and configure different formats and search fields or different criteria like license model, publication date, etc.
Search fields in dynamic sets
In addition to a „free text” search query it is possible to query some search field individually as shown below: documentType, issued, isbn, issn, ppn, licenseModel, author, mainTitle, Abstract, Dclassification.
Some search fields have specific values which can be used to receive different documents types. Those are explained in the following sections.
Example queries:
DdocumentType
Example queries: DdocumentType:A
| Value | Search fields |
|---|---|
| A | Audiovisual material |
| B | Book |
| BC | Essay/chapter(book) |
| C | Proceedings |
| CA | Conference |
| D | Theses |
| FD | Research data |
| I | Image |
| J | Magazin |
| K | Map |
| JL | Article (journal) |
| PP | Preprint |
| LA | Artikel (Lexikon) |
| M | 3D-Model |
| P | Patent |
| PA | Paper |
| R | Report |
| S | Technical rule |
| T | Audio-Material |
DlicenseModel
Example queries:DlicenseModel:oa
Value | Search fields |
|---|---|
| al | Alliance licence |
| kl | Consortial licence |
oa | Open-Access- Document (Free Access) |
com | Commercial documents |
nl | Documents with National License |
Dclassification
Example queries: Dclassification:tec
Value | Search fields |
|---|---|
arc | Architecture |
che | Chemistry |
inf | Computer science |
mat | Mathematics |
phy | Physics |
tec | Technology |
| bio | Biology |
| pae | Education |
| hor | Horticulture |
| geo | Earth sciences |
| his | History |
| lin | Linguistics |
| lit | Literature |
| phi | Philosophy |
| jur | Right |
| rel | Theology |
| sow | Social sciences |
| spo | Sport |
| oek | Economics |
Use and reference conditions
Since July 15, 2016 all catalogue records (oai set “tibkat”) are available for free use under "CreativeCommons Zero” conditions (CC0 1.0). For all other oai sets please request license information via the TIB customer service.
The TIB offers no guarantee that the metadata and online interfaces will be uninterrupted, complete,and that they do not violate rights of third parties (eg as publicity or copyrights).
Contact
Customer service: Monday to Friday from 08:00 to 16:30
T el.: +49 0511 762-8989