Datenschnittstellen der Regesta Imperii - REST

Was bieten die Regesta Imperii unter ihrer REST-Schnittstelle an

Über die REST-Schnittstelle der Regesta Imperii haben Sie Zugriff auf die gesamten Online-Regesten des Projekts Regesta Imperii. Die Regesten sind in XML gemäß den CEI-Richtlinien (vgl. http://www.cei.lmu.de), einem TEI-Dialekt, ausgezeichnet.
Auf dieser Seite wird der "händische" Weg über die REST-Schnittstelle zu den Regesten erklärt. Weitergehende technische Fragen richten Sie gerne an regesta-imperii@adwmainz.de. Die Abkürzung REST wird kurz am Ende der Seite erläutert.
Alternativ bieten wir hier eine Zip-Datei aller Regestendaten, die über die Schnittstelle verfügbar gemacht werden, an.

zurück

Der Weg zum Regest

Kleinste Einheit der ausgelieferten Daten ist das einzelne Regest. Die Regesten sind zusammengefasst in Sammlungen, sog. Collections, die einen Regestenband darstellen.

Auf der Seite www.regesta-imperii.de/cei/ wird eine Liste aller vorhandenen Collections ausgegeben.
Bsp.: www.regesta-imperii.de/cei/ (vgl. Abb. 1)

Kopiert man den Link einer Collection in die Browserzeile und ergänzt ihn um "/sources/" wird eine Liste mit den Links zu den enthaltenen Regesten ausgegeben.
Bsp.: www.regesta-imperii.de/cei/013-014-000/sources/ (vgl. Abb. 2)

Über den Link der einzelnen Regesten erreicht man die XML-Ansicht des jeweiligen Regests.
Bsp: www.regesta-imperii.de/cei/013-014-000/sources/1440-05-16_1_0_13_14_0_7_7 (vgl. Abb. 3)

zurück

Abb. 1: Liste aller Collections
Abb. 2: Liste aller Regesten innerhalb einer Collection (Regestenband)
Abb. 3: XML-Regest

Zum Begriff "REST"

Das Kürzel REST steht für "Representational State Transfer" und bezeichnet ein Programmierparadigma für verteilte Systeme. REST ist eine Abstraktion der Struktur und des Verhaltens des World Wide Web. REST fordert, dass eine Web-Adresse (URI) genau einen Seiteninhalt repräsentiert, und dass ein Web-/REST-Server auf mehrfache Anfragen mit demselben URI auch mit demselben Webseiteninhalt antwortet.
(Vgl. hierzu de.wikipedia.org/wiki/Representational_State_Transfer)

Zur REST-Schnittstelle

zurück