OAI-PMH: Unterschied zwischen den Versionen

Aktuelle Version vom 3. Juli 2025, 16:53 Uhr

OAI-PMH Open Archives Initiative Protocol for Metadata Harvesting

Eine OAI^[1]-Schnittstelle dient dem Anreichern und Austausch von Daten aus Online-Datenbanken und kann in APS eingerichtet werden.^[2]

OAI-Schnittstellen

DNB:

https://www.dnb.de/DE/Professionell/Metadatendienste/Datenbezug/OAI/oai_node.html

DDB:

https://pro.deutsche-digitale-bibliothek.de/daten-nutzen/schnittstellen

ID des DDK bei der DDB: IW3AOJYDU4MT3MFK77H6L6RJ4VJG3LKF

ListIdentifiers (DDK @ DDB):

https://oai.deutsche-digitale-bibliothek.de/?verb=ListIdentifiers&metadataPrefix=oai_dc&set=30350785121479529ktbW:IW3AOJYDU4MT3MFK77H6L6RJ4VJG3LKF

ListRecords (DDK @ DDB):

https://oai.deutsche-digitale-bibliothek.de/?verb=ListRecords&metadataPrefix=oai_dc&set=30350785121479529ktbW:IW3AOJYDU4MT3MFK77H6L6RJ4VJG3LKF

In der Erfassung bei Foto Marburg werden die Daten über den OAI-Status von der Erfassungsdatenbank in die Redaktion und anschließend in die Publikation weitergeleitet.

Identify

Die Query-Parameter^[3] "?verb=Identify" zeigen allgemeine Informationen zu einer OAI-Schnittstelle: ^[4]

ListMetadataFormats

Für die Anzeige der verfügbaren Metadatenformate wird der Parameter "ListMetadataFormats" übermittelt:

<metadataPrefix>oai_dc</metadataPrefix>... <metadataPrefix>raw</metadataPrefix>

ListSets

Die "ListSets" informieren darüber, welche Dokumentgruppen, z.B. Objekte, Künstler verfügbar sind.

<setSpec>obj</setSpec>

Beispiel für den Download (nur für freigeschaltete IP-Adressen):

curl -s "https://aps-production.khi.fi.it/oai-pmh?verb=ListSets" -o "khi-ListSets.xml"

ListIdentifiers

"ListIdentifiers" zeigen alle vorhandenen Dokumentnummern zu allen Dokumenttypen an.

https://oai.biblhertz.it/foto/oai-pmh?verb=ListIdentifiers&metadataPrefix=raw

ListRecords

Der Parameter "ListRecords" listet jeweils 100 Dokumente auf:

https://oai.biblhertz.it/foto/oai-pmh?verb=ListRecords&metadataPrefix=raw

Für die nächsten 100 Dokumente werden der "resumptionToken" und für die Gesamtmenge die "completeListSize" benötigt:

<resumptionToken completeListSize="251969" expirationDate="2023-02-16T16:08:50Z">{3b27046c-953b-4b82-8e51-25bae24a48bd}</resumptionToken>

ListRecords mit Angabe des Zeitraums der Aktualisierung:

https://oai.biblhertz.it/foto/oai-pmh?verb=ListRecords&from=2025-06-01T00:00:00Z&until=2025-06-30T23:59:59Z&metadataPrefix=raw&set=raw_obj

GetRecord

Mit "GetRecord" lassen sich gezielt einzelne Dokumente unter Kenntnis der Dokumentnummer aus Element 5000 (OBJ-Dok.-Nr.) abrufen:

Beispiel für den Download einer Datei:

curl -s "https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw" -o "obj08073329.xml"

↑ https://www.openarchives.org/OAI/openarchivesprotocol.html
↑ http://apswiki.de/doku.php?id=aps:aps-schnittstellen
↑ OAI Verbs https://sickle.readthedocs.io/en/latest/oaipmh.html
↑ Manuscripta Medievalia liefert keine Daten aus: http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListRecords&metadataPrefix=oai_dc

[1] ttps://www.openarchives.org/OAI/openarchivesprotocol.html

[2] ttp://apswiki.de/doku.php?id=aps:aps-schnittstellen

[3] OAI Verbs https://sickle.readthedocs.io/en/latest/oaipmh.html

[4] Manuscripta Medievalia liefert keine Daten aus: http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListRecords&metadataPrefix=oai_dc

[1]

[2]

[3]

[4]

@@ Zeile 8: / Zeile 8: @@
 * https://www.dnb.de/DE/Professionell/Metadatendienste/Datenbezug/OAI/oai_node.html
-DDB:
+[[DDB]]:
 * https://pro.deutsche-digitale-bibliothek.de/daten-nutzen/schnittstellen
+ID des DDK bei der DDB: <code>IW3AOJYDU4MT3MFK77H6L6RJ4VJG3LKF</code>
+ListIdentifiers (DDK @ DDB):
+* https://oai.deutsche-digitale-bibliothek.de/?verb=ListIdentifiers&metadataPrefix=oai_dc&set=30350785121479529ktbW:IW3AOJYDU4MT3MFK77H6L6RJ4VJG3LKF
+ListRecords (DDK @ DDB):
+* https://oai.deutsche-digitale-bibliothek.de/?verb=ListRecords&metadataPrefix=oai_dc&set=30350785121479529ktbW:IW3AOJYDU4MT3MFK77H6L6RJ4VJG3LKF
 In der Erfassung bei Foto Marburg werden die Daten über den [[OAI-Status]] von der Erfassungsdatenbank in die Redaktion und anschließend in die Publikation weitergeleitet.
@@ Zeile 24: / Zeile 33: @@
 Für die Anzeige der verfügbaren Metadatenformate wird der Parameter "ListMetadataFormats" übermittelt:
-* http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListMetadataFormats
+* https://heidicon.ub.uni-heidelberg.de/api/v1/plugin/base/oai/oai?verb=ListMetadataFormats
 * https://oai.biblhertz.it/foto/oai-pmh?verb=ListMetadataFormats
 <code><metadataPrefix>oai_dc</metadataPrefix>...
@@ Zeile 41: / Zeile 50: @@
 <code>curl -s "https://aps-production.khi.fi.it/oai-pmh?verb=ListSets" -o "khi-ListSets.xml"</code>
+=== ListIdentifiers ===
+"ListIdentifiers" zeigen alle vorhandenen Dokumentnummern zu allen Dokumenttypen an.
+* https://oai.biblhertz.it/foto/oai-pmh?verb=ListIdentifiers&metadataPrefix=raw
 === ListRecords ===
@@ Zeile 51: / Zeile 66: @@
 <code><resumptionToken completeListSize="251969" expirationDate="2023-02-16T16:08:50Z">{3b27046c-953b-4b82-8e51-25bae24a48bd}</resumptionToken></code>
+ListRecords mit Angabe des Zeitraums der Aktualisierung:
+* https://oai.biblhertz.it/foto/oai-pmh?verb=ListRecords&from=2025-06-01T00:00:00Z&until=2025-06-30T23:59:59Z&metadataPrefix=raw&set=raw_obj
 === GetRecord ===
@@ Zeile 58: / Zeile 77: @@
 * https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw
 * https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08127672&metadataPrefix=raw
+* https://heidicon.ub.uni-heidelberg.de/api/v1/plugin/base/oai/oai?verb=GetRecord&metadataPrefix=lido&identifier=oai:heidicon.ub.uni-heidelberg.de:ed84679c-e602-4b7c-9e77-f8b5c9c97b74
 Beispiel für den Download einer Datei: