Logo des MDZ: Münchener DigitalisierungsZentrum, Digitale Bibliothek. Zur Startseite

Schnittstellen

IIIF-APIs

Sie können die Inhalte der Bayerischen Staatsbibliothek, die im IIIF-Standard angeboten werden, über die APIs (Application Programming Interface) direkt in Webangebote integrieren, ohne dass Sie die Daten selbst herunterladen und vorhalten müssen.

Bitte beachten Sie: Eine kommerzielle Nutzung unserer Digitalisate ist ggf. genehmigungs- und gebührenpflichtig. Weitere Informationen zur Nutzung und evtl. anfallenden Gebühren finden Sie in unseren FAQ.

Die im Folgenden beschriebenen Schnittstellen liefern ihre Antworten mit dem Access-Control-Allow-Origin: * Header aus, der es erlaubt die Daten direkt in client-seitigen JavaScript-Anwendungen zu verwenden. Die Bayerische Staatsbibliothek bietet die IIIF Presentation API und die IIIF Image API an. Erstere erlaubt es auf sogenannte Manifeste im JSON-LD Format für die digitalisierten Objekte zuzugreifen. Aus diesen heraus werden die Endpunkte der Image API für die verschiedenen Faksimile-Bilder referenziert. An jedem dieser Endpunkte ist eine info.json-Datei vorhanden, die es erlaubt, sofort Informationen über das Bild abzurufen.

Presentation API

Über diese Schnittstelle können Sie auf die Metadaten eines Objektes im JSON-Format zugreifen, die sogenannten Manifeste. Sie finden dort neben einer Reihe von bibliographischen Metadaten (.metadata) eine Datenstruktur, die alle Seiten ("Canvases") eines Objektes auflistet (.sequences[0].canvases). Jeder dieser Canvas-Einträge verweist (unter .images[0].resource.service[@id]) auf die entsprechende Image-API, unter der das Bild für die Seite zugänglich ist.

Falls vorhanden, wird OCR (Volltext) für die Seite unter .seeAlso[@id] im hOCR-Format verlinkt. Bitte beachten Sie, dass die Zahl an OCR-Downloads, die pro 24 Stunden gemacht werden können, beschränkt ist. Der Zugang auf die Presentation API ist unbeschränkt.

URL IIIF-Manifest: https://api.digitale-sammlungen.de/iiif/presentation/v2/{object_id}/manifest
Beispiele für ein Manifest:
https://api.digitale-sammlungen.de/iiif/presentation/v2/bsb00012345/manifest
https://api.digitale-sammlungen.de/iiif/presentation/v2/bsb00130380_00157_u001/manifest

Zugrunde liegende Spezifikation: https://iiif.io/api/presentation/2.1/

URL Top-Collection: https://api.digitale-sammlungen.de/iiif/presentation/v2/collection/top

Zugrunde liegende Spezifikation: https://iiif.io/api/presentation/2.1/#collection

Image API

Über diese Schnittstelle können Sie auf die Digitalisat-Bilddaten in den Digitalen Sammlungen zugreifen. Über die URL können Sie steuern, welchen Ausschnitt Sie in welcher Größe, welcher Rotation und welchem Format bekommen möchten. Für mehr Details konsultieren Sie bitte die Dokumentation der IIIF Image API .

Bitte beachten Sie, dass die Zahl an Requests, die pro 24 Stunden an die Image API gerichtet werden können, begrenzt ist.

Bitte beachten Sie, dass die Zahl an OCR-Downloads, die pro 24 Stunden gemacht werden können, beschränkt ist.

Besuchen Sie uns auch auf Github. Dort finden Sie vom MDZ entwickelte IIIF-OpenSource-Software.

Bayerisches Digitales Repositorium

Mit dem Bayerischen Digitalen Repositorium (BDR) wird eine frei zugängliche Schnittstelle angeboten, über die Metadaten für Digitale Objekte bezogen werden können, die an der Bayerischen Staatsbibliothek produziert oder in Kooperation mit ihr entstanden sind. Das BDR ist ein dem OAI Protocol for Metadata Harvesting (OAI-PMH) entsprechendes Repositorium.

RSS-Feed

Der RSS-Feed des Münchener DigitalisierungsZentrums präsentiert die 50 aktuellsten Neuzugänge in den Digitalen Sammlungen in der Reihenfolge ihrer Online-Bereitstellung.