OAI-PMH: Unterschied zwischen den Versionen
| (2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 10: | Zeile 10: | ||
[[DDB]]: | [[DDB]]: | ||
* https://pro.deutsche-digitale-bibliothek.de/daten-nutzen/schnittstellen | * 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. | 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 57: | Zeile 66: | ||
<code><resumptionToken completeListSize="251969" expirationDate="2023-02-16T16:08:50Z">{3b27046c-953b-4b82-8e51-25bae24a48bd}</resumptionToken></code> | <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 === | === GetRecord === | ||
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:
DDB:
ID des DDK bei der DDB: IW3AOJYDU4MT3MFK77H6L6RJ4VJG3LKF
ListIdentifiers (DDK @ DDB):
ListRecords (DDK @ 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]
- 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:
- https://heidicon.ub.uni-heidelberg.de/api/v1/plugin/base/oai/oai?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"
ListIdentifiers
"ListIdentifiers" zeigen alle vorhandenen Dokumentnummern zu allen Dokumenttypen an.
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>
ListRecords mit Angabe des Zeitraums der Aktualisierung:
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
- 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:
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