Schnittstellen und Linked Data

Mit der Angabe einer WIAG-Kennung erhält man alle Elemente eines Datensatzes.

Beispiel:
 

     https://wiag-vocab.adw-goe.de/bischof/data?someid=WIAG-Pers-EPISCGatz-02733&format=json

     https://wiag-vocab.adw-goe.de/bischof/data?someid=WIAG-Pers-EPISCGatz-02733&format=csv

Struktur

Das JSON-Dokument enthält ein Element person, das die einzelnen Angaben zu der Person umfasst. Dazu gehört bei fast allen Personen eine Gruppe von externen Kennungen im Element identifiers sowie eine Liste von Ämtern im Element offices.

Beispiel:

{"person": {"wiagId":"WIAG-Pers-EPISCGatz-10076-001", "familyName":"Braida", "givenName":"Franz Julian", "prefix":"Graf von", "comment_person":"Ep. tit. Hipponensis", "dateOfBirth":"1654", "dateOfDeath":"1727", "identifier": {"viafId":"5652149719115111130002", "wikidataId":"Q12017135"}, "offices":[ {"officeTitle":"Weihbischof", "diocese":"Olmütz", "dateStart":"1703", "dateEnd":"1727"}, {"officeTitle":"Generalvikar", "diocese":"Olmütz", "dateStart":"1703", "dateEnd":"1727"}], "reference": {"title":"Die Bischöfe des Heiligen Römischen Reiches 1648 bis 1803", "author":"Gatz, Erwin", "short":"Gatz, Bischöfe 1648 bis 1803", "pages":"41" } } }

Das CSV-Dokument ist ein UTF-8-Text. Die erste Zeile enthält die Feldbezeichner. Die folgende Zeile enthält die Feldwerte. Die Feldinhalte einer Zeile sind durch Tabulator voneinander getrennt.

Beispiel:

person.wiagId person.familyName person.givenName person.prefix person.comment_person ...
WIAG-Pers-EPISCGatz-10076-001 Braida "Franz Julian" "Graf von" "Ep. tit. Hipponensis" ...

Die meisten Browser zeigen einen Auswahldialog, bei dem entschieden werden kann, ob die Daten in einer Datei gespeichert oder direkt angezeigt werden sollen. Hinweis für Microsoft-Windows Benutzer: Die Anwendung Editor zeigt die Daten korrekt an. Die Anwendung Excel geht meistens von einer anderen Kodierung als UTF-8 aus und erwartet ein Komma statt des Tabulators als Trennzeichen. Daher ist die Anzeige direkt in Excel meistens nicht sinnvoll. Die Daten können aber aus einer Datei heraus über den Importdialog korrekt eingelesen werden, indem die Auswahl für Dateiursprung und Trennzeichen entsprechend eingestellt werden.

Mit der Angabe von Suchparametern erhält man alle Datensätze, die der Suchanfrage entsprechen. Gesucht werden kann nach folgenden Eigenschaften:

• name: Finde Übereinstiadw-goe.de/domherr/datmmugen in Vorname, Nachname, Namenspräfix, Varianten des Vornamens und Varianten des Nachnamens. Beispiele: josef, graf, gondo, Franz Josef Graf von Gondola
• diocese: Finde Übereinstimmugen in den Namen der Bistümer, in denen die Person ein Amt innehatte. Beispiele: burg, würzburg.
• office: Finde Übereinstimmungen in den Amtsbezeichnungen. Beispiele: vikar, administrator.
• year: Finde Übereinstimmungen für einen Zeitraum von plus/minus 50 Jahren zu der angegebenen Jahreszahl. Berücksichtigt wird für die einzelne Person der größte Zeitraum, der sich ergibt aus Geburtsdatum, Sterbedaten, Amtsbeginn und Amtsende.
• someid: Finde eine exakte Übereinstimmung mit einer Kennung für eine Person in folgenden Verzeichnissen:
  • WIAG
  • Personendatenbank der Germania Sacra
  • Gemeinsame Normdatei (GND)
  • Wikidata
  • Virtual International Authority File (VIAF)

Die Suchparameter sind logisch UND-verknüpft: Es werden nur solche Datensätze angezeigt, für die alle Parameter/Wert-Kombinationen zutreffen. Die Suchparameter werden an die URL jeweils mit dem Schlüsselwort angehängt. Ebenso wird das gewünschte Format mit dem Schlüsselwort format angehängt. JSON ist das Standard-Format, d.h., hier kann die Angabe des Formats entfallen: http://wiag-vokabulare.uni-goettingen.de/api/query-bishops?key1=value&key2=value&format=[json|csv]

Beispiele (JSON):

https://wiag-vocab.adw-goe.de/domherr/data?name=clemens&format=json

https://wiag-vocab.a?name=Hohenlohe&domstift=Bamberg

https://wiag-vocab.adw-goe.de/domherr/data?domstift=Trier&year=1450&format=json

https://wiag-vocab.adw-goe.de/domherr/data?someid=WIAG-Pers-CANON-24965-001&format=json

https://wiag-vocab.adw-goe.de/domherr/data?someid=Q1659745&format=json

Beispiele (CSV):

https://wiag-vocab.adw-goe.de/domherr/data?name=clemens&format=csv

https://wiag-vocab.adw-goe.de/domherr/data?name=Hohenlohe&domstift=Bamberg&format=csv

https://wiag-vocab.adw-goe.de/domherr/data?domstift=Trier&year=1450&format=csv

https://wiag-vocab.adw-goe.de/domherr/data?someid=WIAG-Pers-CANON-24965-001&format=csv

https://wiag-vocab.adw-goe.de/domherr/data?someid=Q1659745&format=csv

Struktur

Das JSON-Dokument enthält ein Element persons, mit den Kindern count (Anzahl der Datensätze) und list (Liste der Datensätze).

Beispiel:

{"persons": {"count":22, "list": [{"person": {"wiagId":"WIAG-Pers-EPISCGatz-3302-001", "familyName":"Hohenlohe", ... } "person": {"wiagId":"WIAG-Pers-EPISCGatz-21477-001", "familyName":"Hohenlohe", ... } ... } ] } }

Das CSV Dokument ist ein UTF-8-Text. Die erste Zeile enthält die Feldbezeichner. Die folgenden Zeilen enthalten die Feldwerte. Die Feldinhalte einer Zeile sind durch Tabulator voneinander getrennt.

Beispiel:

person.wiagId person.familyName person.givenName person.variantFamilyName person.comment_name person.prefix person.comment_person ...
WIAG-Pers-EPISCGatz-3627-001 "Falkenstein und Königstein" Werner von ...
WIAG-Pers-EPISCGatz-21476-001 Aldendorf Konrad von "Ep. tit. Azotensis" ...
WIAG-Pers-EPISCGatz-21477-001 Eydel Tilman von "Ep. tit. Azotensis ?" ...
WIAG-Pers-EPISCGatz-3673-001 Blankenheim Friedrich von ...
WIAG-Pers-EPISCGatz-21281-001 "Franqueloy de Vico" Joannes "Ep. tit. Taurisiensis" ...

Mit der Angabe einer WIAG-Kennung erhält man alle Elemente eines Datensatzes. Die URL hat folgenden Aufbau: https://wiag-vocab.adw-goe.de/api/diocese/[ID]?format=[json|csv].

Beispiel:

wiag-vocab.adw-goe.de/domherr/data?

Struktur

Das JSON-Dokument enthält ein Element diocese, das die einzelnen Angaben zu dem Bistum umfasst. Dazu gehört bei fast allen Bistümern eine Gruppe von externen Kennungen im Element identifiers sowie eine Liste von alternativen Bezeichnungen in unterschiedlichen Sprachen im Element altLabels.

Beispiel:

{ "diocese": { "wiagid": "WIAG-Dioc-47-001", "name": "Basel", "status": "Bistum", "dateOfFounding": "4. Jahrhundert", "dateOfDissolution": "1803", "altLabels": [ { "altName": { "name": "ecclesia Basileensis", "lang": "la" } }, { "altName": { "name": "Bâle", "lang": "fr" } }, { "altName": { "name": "Basilea" } } ], "note": "Erste Erwähnungen eines Bischofs in Kaiseraugst bei Basel gehen auf 343/346 zurück. Die Kontinuität zum späteren Bistum Basel bleibt jedoch offen. Zur eigentlichen Christianisierung kam es erst im 7. Jahrhundert", "ecclesiasticalProvince": "Besançon", "bishopricSeat": "Basel", "noteBishopricSeat": "Im Zuge der Reformation wurden Bischof und Domkapitel aus Basel vertrieben. Die Bischöfe residierten seit 1527 in Pruntrut (Porrentruy), das Domkapitel in Freiburg im Breisgau, ab 1678 in Arlesheim.", "identifiers": { "Factgrid": "Q153251", "Gemeinsame Normdatei (GND) ID": "2029618-6", "Wikipedia-Artikel": "Bistum Basel", "Wikidata": "Q182492", "VIAF-ID": "131932928", "Catholic Hierarchy, Diocese": "dbase.html" }, "identifiersComment": "Alle Normdaten nehmen sowohl auf das Fürstbistum als auch auf das heutige Bistum Basel Bezug." } }