OAI-PMH
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:
DDB:
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]
- http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=Identify
- https://oai.biblhertz.it/foto/oai-pmh?verb=Identify
- https://heidicon.ub.uni-heidelberg.de/api/v1/plugin/base/oai/oai?verb=Identify
ListMetadataFormats
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://oai.biblhertz.it/foto/oai-pmh?verb=ListMetadataFormats
<metadataPrefix>oai_dc</metadataPrefix>...
<metadataPrefix>raw</metadataPrefix>
ListSets
Die "ListSets" informieren darüber, welche Dokumentgruppen, z.B. Objekte, Künstler verfügbar sind.
- http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListSets
- https://oai.biblhertz.it/foto/oai-pmh?verb=ListSets
<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"
ListRecords
Der Parameter "ListRecords" listet jeweils 100 Dokumente auf:
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>
GetRecord
Mit "GetRecord" lassen sich gezielt einzelne Dokumente unter Kenntnis der Dokumentnummer aus Element 5000 (OBJ-Dok.-Nr.) abrufen:
- 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
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