# Interface Museums-Online

Museums-Online est une plateforme de présentation d'objets de musée. AGORA propose une interface qui permet à Museums-Online d'interroger des données au format Dublin Core. La configuration de l'interface est décrite dans la documentation utilisateur.

# Utilisation de l'interface

Pour utiliser l'interface, l'URL doit contenir certains paramètres de requête :

https://[Votre-Domaine]/api/museums-online/?query=[Votre-Requête]&maximumRecords=[Nombre]&startRecord=[Offset]
  • query : Terme de recherche optionnel pour la recherche en texte intégral.
  • maximumRecords : Paramètre optionnel. La valeur par défaut et le maximum sont configurés dans le schéma d'archive.
  • startRecord : Paramètre optionnel. L'offset pour la pagination (par défaut : 0).

# Exemples

  • Récupérer tous les enregistrements :
https://dls.example.ch/api/museums-online/
  • Recherche par terme :
https://dls.example.ch/api/museums-online/?query=Skulptur
  • Pagination :
https://dls.example.ch/api/museums-online/?maximumRecords=10&startRecord=20

Exemple de réponse

<?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>