API Dokumentation
Inhaltsverzeichnis
http/https
Die Seiten der WeGA können sowohl über http als auch über verschlüsseltes https abgerufen werden.
Die folgenden URL-Beispiele gelten somit immer für beide Protokolle.
Content Negotiation
Via Content Negotiation lassen sich zu einer Ressource verschiedene Ausgabeformate wählen.
Aktuell werden HTML, TEI-XML und Plain Text unterstützt, wobei das gewünschte Ausgabeformat entweder
über ein Suffix (.html/.htm oder .tei/.xml oder .txt) oder über den HTTP Accept Header
(text/html bzw. application/xhtml+xml oder application/xml bzw. application/tei+xml
oder text/plain)
angegeben werden können. Wird beides angegeben, hat das Suffix Vorrang. NB: Die Plain-Text-Ausgabe ist als experimentelles Feature zu verstehen!
Die kanonische URL jeder Ressource setzt sich dabei aus der Domäne „weber-gesamtausgabe.de“ und der ID zusammen.
Beispiele mit curl
# curl -L https://weber-gesamtausgabe.de/A002068.xml
# curl -L https://weber-gesamtausgabe.de/A002068.html
# curl -L -H "Accept: text/html" https://weber-gesamtausgabe.de/A002068
# curl -L -H "Accept: application/xml" https://weber-gesamtausgabe.de/A002068
Bitte beachten Sie, dass der Parameter -L hier benötigt wird, da ggf. eine Weiterleitung erfolgt.
TEI-Ausgabeformate
Wird eine TEI-Datei abgerufen (siehe Content Negotiation), so wird diese standardmäßig im WeGA-TEI-Format ausgeliefert.
Dieses Format ist eine „TEI-Customization“ und dokumentiert unter https://github.com/Edirom/WeGA-ODD.
Alternativ kann über den URL-Parameter format auch eine Ausgabe kompatibel zu „TEI all“ (format=tei_all)
oder „TEI simplePrint“ (format=tei_simplePrint) gewählt werden.
Examples with curl
# curl -L "https://weber-gesamtausgabe.de/A002068.xml?format=tei_all"
# curl -L -H "Accept: application/xml" "https://weber-gesamtausgabe.de/A002068?format=tei_simplePrint"
Siehe auch die News vom 29. November 2017 zu „alternativen TEI-Ausgabeformaten“.
Sprachauswahl
Die HTML-Ausgabe der Ressourcen kann in mehreren Sprachen (Aktuell Deutsch und Englisch) erfolgen.
Dabei werden allerdings nur die Navigations- und Menüelemente übersetzt, nicht jedoch die eigentlichen Texte!
Die Sprachwahl erfolgt über eine URL-Pfadkomponente, de für Deutsch und en für Englisch.
Beispiele mit curl
# curl -L https://weber-gesamtausgabe.de/de/A002068.html
# curl -L -H "Accept: text/html" https://weber-gesamtausgabe.de/en/A002068
Abfragen von GND IDs
Von der API werden aktuell GNDs vom Typ „Person“ (früher PND), Organisation/Körperschaft (früher GKD),
sowie Werk unterstützt,
welche über BEACON-Dateien zur Verfügung gestellt werden.
Die Adressen der BEACON-Dateien sind https://weber-gesamtausgabe.de/pnd_beacon.txt,
https://weber-gesamtausgabe.de/gkd_beacon.txt,
bzw. https://weber-gesamtausgabe.de/works_beacon.txt.
Abfragen können durch Anhängen einer gültigen GND an die Adresse https://weber-gesamtausgabe.de/de/gnd/
gemacht werden. (Zur Sprachwahl siehe oben.)
Beispiele mit curl
# curl -L https://weber-gesamtausgabe.de/de/gnd/118629662
# curl -L -H "Accept: application/tei+xml" https://weber-gesamtausgabe.de/de/gnd/118629662
Detaillierte Informationen zum BEACON-Format finden sich unter https://de.wikipedia.org/wiki/Wikipedia:BEACON .
Correspondence Metadata Interchange-Format
Die WeGA stellt seit Mai 2014 alle Korrespondenz-Metadaten nach dem Correspondence Metadata Interchange-Format (CMI)
zur Verfügung. Adresse der Beacon-Datei: https://weber-gesamtausgabe.de/correspDesc.xml.
Detaillierte Informationen zum CMI-Format finden sich auf den Seiten des correspSearch Webservice und unter https://github.com/TEI-Correspondence-SIG/CMIF . Siehe auch die News vom 7. Mai 2014 zur ersten Einrichtung eines „experimentellen Corresp-Beacon“.
Swagger OpenAPI
Die WeGA bietet unter https://weber-gesamtausgabe.de/api/v1/ ebenfalls eine REST-Schnittstelle nach der Swagger OpenAPI Spezifikation 2.0 an. Diese Schnittstelle soll ein schnelles und komfortables Auffinden von Dokumenten aus der digitalen Edition ermöglichen.
