API Dokumentation

Content Negotiation

Via Content Negotiation lassen sich zu einer Ressource verschiedene Ausgabeformate wählen. Aktuell werden HTML und TEI-XML unterstützt, wobei das gewünschte Ausgabeformat entweder über ein Suffix (.html/.htm oder .tei/.xml) oder über den HTTP Accept Header (text/html bzw. application/xhtml+xml oder application/xml bzw. application/tei+xml) angegeben werden können. Wird beides angegeben, hat das Suffix Vorrang.

Die kanonische URL jeder Ressource setzt sich dabei aus der Domäne „weber-gesamtausgabe.de“ und der ID zusammen.

Beispiele mit curl

# curl -L http://weber-gesamtausgabe.de/A002068.xml
# curl -L http://weber-gesamtausgabe.de/A002068.html
# curl -L -H "Accept: text/html" http://weber-gesamtausgabe.de/A002068
# curl -L -H "Accept: application/xml" http://weber-gesamtausgabe.de/A002068

Bitte beachten Sie, dass der Parameter -L hier benötigt wird, da ggf. eine Weiterleitung erfolgt.

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 http://weber-gesamtausgabe.de/de/A002068.html
# curl -L -H "Accept: text/html" http://weber-gesamtausgabe.de/en/A002068

Abfragen von GND IDs

Von der API werden aktuell GNDs vom Typ „Person“ unterstützt, welche über einen PND-Beacon zur Verfügung gestellt werden. Adresse der Beacon-Datei: http://weber-gesamtausgabe.de/pnd_beacon.txt. Abfragen können durch Anhängen einer gültigen GND an die Adresse http://weber-gesamtausgabe.de/de/pnd/ gemacht werden. (Zur Sprachwahl siehe oben.)

Beispiele mit curl

# curl -L http://weber-gesamtausgabe.de/de/pnd/118629662
# curl -L -H "Accept: application/tei+xml" http://weber-gesamtausgabe.de/de/pnd/118629662

Detaillierte Informationen zum PND-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: http://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.

XML

XML Download

Wenn Ihnen auf dieser Seite ein Fehler oder eine Ungenauigkeit aufgefallen ist,
so bitten wir um eine kurze Nachricht an bugs [@] weber-gesamtausgabe.de.