Handbuch zum OAI-Protokoll: https://www.openarchives.org/OAI/openarchivesprotocol.html

Beispiel einer OAI-Schnittstelle, Repository „Manuscripta Mediaevalia“: http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=Identify

Ende 2018 wurde eine OAI-Schnittstelle im APS der Bibliotheca Hertziana eingerichtet, das den Datentausch im Bildindex mit Foto Marburg (DDK) gewährleisten soll. Sie wird noch getestet, Daten können schon abgerufen werden.

https://oai.biblhertz.it/foto/oai-pmh?verb=Identify&RepoName=BHRZ-Partner

Inzwischen ist der proprietäre Parameter „RepoName“ nicht mehr notwendig.

https://oai.biblhertz.it/foto/oai-pmh?verb=Identify

„RepoName“ sei laut Foto Marburg (DDK) ein APS-interner Parameter, der von der Syntax kein OAI-PMH sei.

&RepoName=BHRZ-Partner

Insofern sind Base-URL und RepoName noch nicht validiert, auch der metadataPrefix sei für das DDK noch nicht ausreichend. Dublin Core ist als „metadataPrefix = oai_dc“ nun eingerichtet, liefert aber bisher nur eine ID.

• Base-URL = https://oai.biblhertz.it/foto/oai-pmh
• RepoName = BHRZ-Partner
• Set = obj, kue, objkue
• metadataPrefix = raw

Das Set gibt an, ob es sich um Objekte oder Künstlerdokumente oder beides handelt. ListRecords listet Dateien aus einem bestimmten Datumsbereich:

https://oai.biblhertz.it/foto/oai-pmh?RepoName=BHRZ-Partner&verb=ListRecords&from=2018-12-01T00:00:00Z&until=2018-12-12T18:00:00Z&metadataPrefix=raw&set=obj

Z.B. OBJ-Daten vom Januar 2019:

https://oai.biblhertz.it/foto/oai-pmh?verb=ListRecords&from=2019-01-01T00:00:00Z&until=2019-01-31T23:59:59Z&metadataPrefix=raw&set=obj

GetRecord zeigt einzelne Datei nach Dokument-(OBJ-)Nummer:

https://oai.biblhertz.it/foto/oai-pmh?RepoName=BHRZ-Partner&verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw

https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw

Das Testen einer OAI-Schnittstelle kann erfolgen über http://re.cs.uct.ac.za/. Der Test der BaseURI https://oai.biblhertz.it/foto/oai-pmh liefert derzeit noch 9 Fehler, funktioniert aber grundsätzlich.

Die Anzeige eines OBJ-Dokumentes erfolgt über die ID:

https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08127672&metadataPrefix=raw