API-Tool e-rara & e-manuscripta

Metadaten, Volltexte, Entitäten und mehr

Titel herunterladen

Eine Eingabe für alle Downloads eines Werks: VLID (), -Link oder DOI (). Eine Auswahl ergibt eine Datei, mehrere ein ZIP. Mit Proxy markierte Inhalte sperrt für Browser-Skripte; ohne Proxy erscheinen sie als direkte Links.

Werk
Inhalte
Optionen

Das Metadatenformat gilt für XML, JSON und CSV. Ohne Proxy stammen JSON und CSV aus den Katalogangaben des IIIF-Manifests (Titel, Autor, Impressum, Umfang, Besitz, DOI); mit Proxy aus Dublin Core bzw. MODS.

Seiten

Entweder Werk + Bildnummer(n) – Werk als VLID, DOI oder Link, Bildnummern wie 30, 1-3, 30-35 oder alle – oder nur eine Seiten-VLID bzw. ein Link aus der Seitenansicht. Die Bildnummer zählt die Digitalisate ab 1 und weicht meist von der gedruckten Seitenzahl ab. Alle Funktionen dieses Bereichs laufen ohne Proxy.

Auswahl
Bildoptionen (für Vorschau und «Bild(er)»)
Bildgrösse

Breite in Pixeln; die Höhe ergibt sich aus dem Seitenverhältnis. «Originalauflösung» liefert die grösste Datei.

Ausschnitt

Welcher Teil der Seite ausgegeben wird; die Bildgrösse bezieht sich danach auf diesen Ausschnitt.

Drehung

Gespiegelt wird vor dem Drehen.

Farbe

Graustufen und Schwarz-weiss ergeben kleinere Dateien und eignen sich für Druck und Texterkennung.

IIIF-Anfrage: · Format immer JPEG ( liefert nur JPEG) · Parameter gemäss IIIF Image API 2.0

Mehrere Seiten: Text als eine Datei mit Trennzeilen, Bilder und ALTO als ZIP.

Sammlung harvesten

Metadaten eines Sets oder Zeitraums über OAI-PMH. liefert 10 Datensätze pro Abruf; 1000 Datensätze dauern etwa 1–2 Minuten. Zusätzliche Inhalte je Titel verlängern die Laufzeit deutlich.

Auswahl
Zeitraum (erfasst/geändert)
Ausgabe

Faustregel: Für eine Tabelle oai_dc (kompakt) oder mods (ausführlich) mit CSV wählen; für Programme JSON; für Struktur, Dateien und Archivierung mets/arcmets als XML.

Zusätzlich je Titel (optional)

CORS-Proxy (optional)

e-rara und e-manuscripta erlauben Browser-Skripten den Zugriff auf Volltexte, Entitäten und IIIF, nicht aber auf OAI-PMH, RIS, PDF und die DOI-Auflösung. Ein CORS-Proxy reicht solche Anfragen weiter und schaltet damit Harvesting, Plattform-Angaben und die Umwandlung von Dublin Core/MODS in CSV/JSON frei.

{url} wird durch die (kodierte) e-rara- bzw. e-manuscripta-Adresse ersetzt; ohne {url} wird sie angehängt. Öffentliche Proxys sehen alle Anfragen und sind oft gedrosselt – für regelmässige Nutzung besser einen eigenen Proxy betreiben (Anleitung, englisch).

Was funktioniert wie?

Inhaltohne Proxymit Proxy
Volltext Titel/Seite (Text, ALTO), Entitäten (MADS, JSON, CSV), IIIF-Manifest, Bilderjaja
e-manuscripta: keine Entitäten; Volltexte nur seitenweise unter «Seiten».
Titelangaben, Vorschau, Seitenauswahlja (aus IIIF)ja
Metadaten XML (oai_dc, mods, mets …), RIS, PDFals direkter Linkja, auch im ZIP
Metadaten als JSON/CSVvereinfacht (aus IIIF)Dublin Core / MODS
DOI als Eingabeüber DataCite (falls erreichbar)ja
Sammlung harvesten, Anzahl prüfen, Plattform-Angabennein (Links zur OAI-Schnittstelle)ja