Inhalt
Seitenhistorie
...
Für die folgenden Beispiele wird die Domäne expo.bsz-bw.de verwendet. Nach der Domänenangabe folgen die URL-Komponenten, die die anwendungsspezifische Installation der Schnittstelle bezeichnen. Sie bestehen in der Regel aus einem dreistelligen Kürzel des Museums, z.B. sgs, smf, etc., sowie einer Bezeichnung der Teilsammlung bzw. intendierten Anwendung, z.B. sammlung-online oder digitaler-katalog. Insgesamt ergibt sich bis dahin also z.B. https://expo.bsz-bw.de/sgs/sammlungdigitaler-onlinekatalog. Dann folgen die Methoden der Schnittstellen /selekt, /image etc. und schließlich der durch „?“ abgetrennte Querystring. Die URL-Parameter werden im Querystring der URL als name=value-Paare kodiert, die mit & getrennt sind und deren Reihenfolge nicht signifikant ist. Zur Darstellung von reservierten Zeichen (z.B. Leerzeichen) und Sonderzeichen ist ein URL-Encoding der Parameterwerte erforderlich.
...
Soweit die Pfade auf das sog. "Z-Laufwerk" des BSZ führen, adressieren sie kleingerechnete Arbeitsderivate der Museen in imdas pro. Diese Pfade werden nicht in den Trefferformaten ausgegeben und können nicht direkt zum Abruf dieser Ressourcen über das Web verwendet werden. Vielmehr erfolgt der Abruf von Bildern sowie anderen Mediendateien über einen https-GET-Methode /image, /audio bzw. /pdf in dem die imdasid des Datensatzes, optional die Nummer des Bildes, des Audiofiles bzw. pdfs in der Liste der zum Datensatz publizierten Bilder sowie optional die Bilddimension als Parameter angegeben sind. Folgende Parameter sind dabei vorgesehen:
| Bezeichnung | Beschreibung |
|---|---|
| id | Die Imdas-Id aus der Imdas Pro-Datenbank (s.o.). |
| pos | Die Position des Bildes in der Liste der zum Datensatz publizierten Bilder, wobei die erste Position mit 0 nummeriert ist. Sind z.B. zu einem Objekt fünf Bilder publiziert, bezeichnet img=2 das dritte Bild in dieser Liste (Vorgabewert: „0“). |
| width | Nur bei /image: Bilder werden auf die gewünschte Größe in Pixeln skaliert; die Interpretation diese Werts bestimmt der Parameter mode (Vorgabewert: „100“). |
| mode | Nur bei /image: Für den Parameter mode sind die Werte „h“ width ist die gewünschte Höhe, „w“: width ist die gewünschte Breite, sowie „x“: width ist das größere von Länge und Breite, also ein umfassendes Quadrat (Vorgabewert: „x“) |
| lang | Nur bei /audio: Liegen Audiofiles in verschiedenen Sprachen „de“, „en“, „fr“,… vor, bestimmt lang die Sprachvariante. (Vorgabe: „de“) |
Bilder werden im JPG-Format unter dem Mimetype „image/jpeg“ ausgeliefert, Audio-Dateien unter dem Mimetype „audio/mpeg“ sowie PDF-Dateien unter dem Mimetype „application/pdf“.
...
Überblick
Inhalte