# Museums-Online-Schnittstelle

Museums-Online ist eine Plattform für die Präsentation von Museumsobjekten. AGORA bietet eine Schnittstelle an, die es Museums-Online ermöglicht, Daten im Dublin-Core-Format abzufragen. Die Konfiguration der Schnittstelle wird in der Benutzerdokumentation beschrieben.

# Nutzung der Schnittstelle

Um die Schnittstelle zu nutzen, muss die URL bestimmte Query-Parameter enthalten:

https://[Ihre-Domain]/api/museums-online/?query=[Ihre-Abfrage]&maximumRecords=[Anzahl]&startRecord=[Offset]

query: Optionaler Suchbegriff für die Volltextsuche.
maximumRecords: Optionaler Parameter. Der Standardwert und das Maximum werden im Archiv Schema konfiguriert.
startRecord: Optionaler Parameter. Der Offset für die Paginierung (Standard: 0).

# Beispiele

Alle Datensätze abrufen:

https://dls.example.ch/api/museums-online/

Suche nach einem Begriff:

https://dls.example.ch/api/museums-online/?query=Skulptur

Paginierung:

https://dls.example.ch/api/museums-online/?maximumRecords=10&startRecord=20

Beispielantwort

<?xml version='1.0' encoding='UTF-8'?>
<zs:searchRetrieveResponse xmlns:zs="http://www.loc.gov/zing/srw/">
  <zs:version>1.2</zs:version>
  <zs:numberOfRecords>2</zs:numberOfRecords>
  <zs:records>
    <zs:record>
      <zs:recordData>
        <dc xmlns:dc="http://purl.org/dc/elements/1.1/">
          <dc:title>Bronzefigur</dc:title>
          <dc:creator>Max Muster</dc:creator>
          <dc:identifier>INV-001</dc:identifier>
          <dc:identifier>https://dls.example.ch/records/123</dc:identifier>
          <dc:identifier>https://s3.example.ch/thumbnails/123/1000.webp</dc:identifier>
        </dc>
      </zs:recordData>
      <zs:recordPosition>1</zs:recordPosition>
    </zs:record>
    <zs:record>
      <zs:recordData>
        <dc xmlns:dc="http://purl.org/dc/elements/1.1/">
          <dc:title>Ölgemälde</dc:title>
          <dc:identifier>https://dls.example.ch/records/456</dc:identifier>
        </dc>
      </zs:recordData>
      <zs:recordPosition>2</zs:recordPosition>
    </zs:record>
  </zs:records>
</zs:searchRetrieveResponse>

← SRU-Schnittstelle