API
Benutzung API
Beta-Version: Der API-Datenexport ist zu Testzwecken online geschaltet. Beim Prozess der Stabilisierung können sich geringfügige Änderungen an den exportierten Datensätzen ergeben, sodass ggf. automatische Auswertungsskripte angepasst werden müssen. Für Feedback sprechen Sie uns gerne an.
Die Module der API werden über Domänensegmente angesprochen. Im Moment steht folgendes Modul zur Verfügung:
search
Mit dem search-Modul können Volltextsuchen oder komplexe Suchen mit Hilfe der Elasticsearch Query DSL und als Simple Query String Query durchgeführt werden. Das Suchergebnis ist eine Liste von Verlagsartikeln und steht im Moment ausschließlich im json-Format zur Verfügung.
Leere Suche
Der search-Endpunkt kann ohne Parameter angesprochen werden und liefert alle verfügbaren Datensätze zurück.
https://musikverlage.slub-dresden.de/api/search
Beispiele Volltextsuche als Simple Query String
Dem q-Parameter kann eine Abfrage-Zeichenkette übergeben werden.
https://musikverlage.slub-dresden.de/api/search?q=Dotzauer
Sollen Begriffe in verschiedenen Feldern gesucht werden, müssen sie über AND oder OR verbunden werden.
https://musikverlage.slub-dresden.de/api/search?q=Requiem AND Brahms
Beispiel Feldsuche als Simple Query String
Die zu durchsuchenden Felder können mit dem fields-Parameter spezifiziert werden.
https://musikverlage.slub-dresden.de/api/search?q=Lied&fields=title
Der fields-Parameter kann auch eine kommaseparierte Liste erhalten.
https://musikverlage.slub-dresden.de/api/search?q=Leipzig &fields=works.composers.place_of_birth,works.composers.place_of_death
Suchfenstergröße
Alle Suchanfragen liefern die ersten 10 Ergebnisse. Die Suchfenstergröße kann über den size-Parameter auf maximal 10 000 Ergebnisse angepasst werden. Das Suchfenster kann über den from-Parameter verschoben werden.
https://musikverlage.slub-dresden.de/api/search?q=Piano&fields=title&size=5&from=15
Fuzziness
Den Suchwörtern kann mit dem ~-Parameter eine Anzahl von ersetzbaren Zeichen angefügt werden, sodass auch ähnlich geschriebene Wörter gefunden werden. Bspw. liefert folgende Suche auch Suchergebnisse für die französische Schreibweise "Mélodie".
https://musikverlage.slub-dresden.de/api/search?q=Melodie~1