Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung
Vorhergehende Überarbeitung
oai-pmh:api:listrecords [2025/11/30 12:58] – angelegt bcadminoai-pmh:api:listrecords [2025/12/07 12:49] (aktuell) bcadmin
Zeile 5: Zeile 5:
 </WRAP> </WRAP>
 <WRAP left> <WRAP left>
-====== BeeCollect Cloud: OAI-PMH-Service ======+====== OAI-PMH-Service ======
 == ListRecords == == ListRecords ==
 </WRAP> </WRAP>
Zeile 18: Zeile 18:
 <WRAP twothirds column> <WRAP twothirds column>
  
 +===== Beschreibung =====
 +
 +Diese Abfrage liefert eine Liste von Datensätze inkl. der enthaltenen Metadaten im angegeben Format.
 +
 +===== Aufruf =====
 +
 +<code>
 +https://beecollect.cloud/oai?verb=ListRecords
 +</code>
 +
 +===== Parameter =====
 +
 +==metadataPrefix==
 +Die Datensätze werden mit den Metadaten des hier angegebenen Formats aufgelistet. Demzufolge werden auch nur Datensätze aufgelistet, welche das entsprechende Metadatenformat bereitstellen. Die verfügbaren Metadatenformate können mit listMetadataFormats abgerufen werden.
 +
 +Dieser Parameter ist **verpflichtend**. 
 +
 +==from==
 +Im Ergebnis werden nur Datensätze aufgelistet, die ab (inkl.) dem angegebenen Datum verändert wurden. Die Datumsangabe muss im Format //UTC DateTime// erfolgen, also z.B. 2024-01-07T10:30:00Z.
 +
 +Dieser Parameter ist optional.
 +
 +==until==
 +Im Ergebnis werden nur Datensätze aufgelistet, die bis (inkl.) dem angegebenen Datum verändert wurden. Die Datumsangabe muss im Format //UTC DateTime// erfolgen, also z.B. 2024-01-07T10:30:00Z.
 +
 +Dieser Parameter ist optional.
 +
 +==set==
 +Im Ergebnis werden nur Datensätze aufgelistet, die dem angegebenen Set oder einem diesem untergeordneten Set zugewiesen sind. Die verfügbaren Sets können mit listSets abgerufen werden.
 +
 +Dieser Parameter ist optional.
 +
 +==resumptionToken==
 +Überschreitet die Ergebnismenge der gelieferten Datensatz-Header die Anzahl von 50 Treffern, werden in der Response automatisch nur die ersten 50 Einträge sowie ein sogenanntes ResumptionToken geliefert. Dieses muss dann in einer Folgeabfrage über diesen Parameter angegeben werden, um die nächsten maximal 50 Einträge zu erhalten.
 +
 +Der Parameter muss bei bei Bedarf angegeben werden. 
 +
 +===== Response =====
 +
 +<code>
 +<?xml version="1.0" encoding="utf-8"?>
 +<OAI-PMH xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ https://www.openarchives.org/OAI/2.0/OAI-PMH.xsd http://www.openarchives.org/OAI/2.0/oai_dc/ https://www.openarchives.org/OAI/2.0/oai_dc.xsd" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/" xmlns:edm="http://www.europeana.eu/schemas/edm/" xmlns="http://www.openarchives.org/OAI/2.0/">
 +    <responseDate>2024-06-02T15:03:05Z</responseDate>
 +    <request verb="ListRecords">https://beecollect.cloud/oai?verb=ListRecords&amp;metadataPrefix=oai_dc&amp;set=SOLVATEC</request>
 +    <ListRecords>
 +        <record>
 +            <header>
 +                <identifier>oai:beecollect.cloud:9b238763-b12c-4ccb-bd15-82238da3a3dc</identifier>
 +                <datestamp>2023-07-01T14:24:15Z</datestamp>
 +                <setSpec>SOLVATEC:art:paintings</setSpec>
 +            </header>
 +            <metadata>
 +                <oai_dc:dc xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/">
 +                    <dc:title>Parforce-Jagdhorn</dc:title>
 +                    <dc:description>Horn (Musikinstrument)</dc:description>
 +                    <dc:date>um 1822</dc:date>
 +                    <dc:identifier>AK 2913.135</dc:identifier>
 +                </oai_dc:dc>
 +            </metadata>
 +        </record>
 +        <record>
 +            <header>
 +                <identifier>oai:beecollect.cloud:88b946d1-ef3e-4872-81af-26aa9f48452f</identifier>
 +                <datestamp>2023-07-01T14:24:16Z</datestamp>
 +                <setSpec>SOLVATEC:art:prints</setSpec>
 +            </header>
 +            <metadata>
 +                <oai_dc:dc xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/">
 +                    <dc:title>Belvedere</dc:title>
 +                    <dc:description />
 +                    <dc:identifier>DL 2021/1, 10</dc:identifier>
 +                </oai_dc:dc>
 +            </metadata>
 +        </record>
 +        <record>
 +            <header>
 +                <identifier>oai:beecollect.cloud:c1ea19da-6f64-4848-acb8-b0797c8e5bc5</identifier>
 +                <datestamp>2023-07-01T14:24:16Z</datestamp>
 +                <setSpec>SOLVATEC:art:paintings</setSpec>
 +            </header>
 +            <metadata>
 +                <oai_dc:dc xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/">
 +                    <dc:title>Doppelpedalharfe</dc:title>
 +                    <dc:description>Harfe</dc:description>
 +                    <dc:date>1826</dc:date>
 +                    <dc:identifier>AK 1995.245</dc:identifier>
 +                </oai_dc:dc>
 +            </metadata>
 +        </record>
 +    </ListRecords>
 +</OAI-PMH>
 +</code>
  
 </WRAP> </WRAP>
 </WRAP> </WRAP>