OAI-PMH: Unterschied zwischen den Versionen
imported>Glorius |
|||
(12 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 2: | Zeile 2: | ||
Eine OAI<ref>https://www.openarchives.org/OAI/openarchivesprotocol.html</ref>-Schnittstelle dient dem Anreichern und Austausch von Daten aus Online-Datenbanken und kann in [[APS]] eingerichtet werden.<ref>http://apswiki.de/doku.php?id=aps:aps-schnittstellen</ref> | Eine OAI<ref>https://www.openarchives.org/OAI/openarchivesprotocol.html</ref>-Schnittstelle dient dem Anreichern und Austausch von Daten aus Online-Datenbanken und kann in [[APS]] eingerichtet werden.<ref>http://apswiki.de/doku.php?id=aps:aps-schnittstellen</ref> | ||
=== 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 | |||
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 7: | Zeile 15: | ||
=== Identify === | === Identify === | ||
Die Query-Parameter "?verb=Identify" zeigen allgemeine Informationen zu einer OAI-Schnittstelle: | Die Query-Parameter<ref>OAI Verbs https://sickle.readthedocs.io/en/latest/oaipmh.html</ref> "?verb=Identify" zeigen allgemeine Informationen zu einer OAI-Schnittstelle: <ref>Manuscripta Medievalia liefert keine Daten aus: http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListRecords&metadataPrefix=oai_dc</ref> | ||
* https://oai.biblhertz.it/foto/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 === | === ListMetadataFormats === | ||
Für die Anzeige der Metadatenformate wird der Parameter "ListMetadataFormats" übermittelt: | 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 | * https://oai.biblhertz.it/foto/oai-pmh?verb=ListMetadataFormats | ||
<metadataPrefix>oai_dc</metadataPrefix> | <code><metadataPrefix>oai_dc</metadataPrefix>... | ||
<metadataPrefix>raw</metadataPrefix> | <metadataPrefix>raw</metadataPrefix></code> | ||
=== ListSets === | === ListSets === | ||
Zeile 29: | Zeile 37: | ||
<code><setSpec>obj</setSpec></code> | <code><setSpec>obj</setSpec></code> | ||
Beispiel für den Download (nur für freigeschaltete IP-Adressen): | |||
<code>curl -s "https://aps-production.khi.fi.it/oai-pmh?verb=ListSets" -o "khi-ListSets.xml"</code> | |||
=== ListRecords === | === ListRecords === | ||
Zeile 34: | Zeile 46: | ||
Der Parameter "ListRecords" listet jeweils 100 Dokumente auf: | Der Parameter "ListRecords" listet jeweils 100 Dokumente auf: | ||
* https://oai.biblhertz.it/foto/oai-pmh?metadataPrefix=raw | * 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: | Für die nächsten 100 Dokumente werden der "resumptionToken" und für die Gesamtmenge die "completeListSize" benötigt: | ||
Zeile 46: | Zeile 58: | ||
* 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::08073329&metadataPrefix=raw | ||
* https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08127672&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: | |||
<code>curl -s "https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw" -o "obj08073329.xml"</code> | |||
----------- | ----------- | ||
<references/> | <references/> |
Aktuelle Version vom 6. November 2024, 11:30 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:
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"
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
- 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