Der Bestand des Archivs ist maschinell abrufbar — als JSON, ohne Anmeldung, ohne Schlüssel. Gedacht für eigene Auswertungen und dafür, dass Sprachmodelle das Archiv befragen können, ohne HTML zerlegen zu müssen.
Das Werk ist die Einheit, die man sucht und zitiert — ein
Dokument, eine Aufnahme, ein Bild. Zu einem Werk gehören eine oder mehrere
Dateien; welche Aufgabe jede hat, sagt das Feld rolle. Erzeugte
Vorschaubilder zählen nirgends mit, sie dienen nur der Anzeige.
| rolle | Anzahl | was es ist |
|---|---|---|
| haupt | 843 | das Werk als einzelne Datei |
| seite | 828 | einzelnes Blatt eines nur als Scanfolge vorliegenden Werks |
| transkript | 288 | Transkript einer Tonaufnahme, maschinell erstellt |
| fassung | 96 | zweite Fassung, etwa fürs Abspielen umkodiert |
| anhang | 0 | Beilage zum Werk |
Die Zahl unter haupt liegt um 9
unter der Werkzahl. Das sind Werke, die nur als Folge gescannter Blätter
vorliegen und keine einzelne Quelldatei haben — „Elementarstrukturen der Materie 1“
etwa besteht aus 223 Einzelscans.
Interaktive Beschreibung öffnen OpenAPI-Beschreibung (JSON)
Die interaktive Ansicht listet alle Endpunkte samt Parametern und lässt sie direkt im Browser ausprobieren. Die OpenAPI-Beschreibung eignet sich zum Einlesen in eigene Werkzeuge. Beide Ansichten werden vollständig von diesem Server ausgeliefert — es wird nichts von fremden Servern nachgeladen.
Alle Aufrufe sind lesend und antworten mit JSON in UTF-8. Es gibt keinen Schlüssel und keine Begrenzung der Aufrufzahl — bitte trotzdem mit Maß. Ausgeliefert wird ausschließlich, was auch im Browser öffentlich sichtbar ist; interner Bestand bleibt außen vor.
Höchstens 200 Werke je Abruf. Zum Durchblättern
limit und offset verwenden; gesamt
in der Antwort nennt die Gesamtzahl.
Durchsucht Titel, Beschreibungen, Hashtags, zugeordnete Personen sowie den Volltext der Dokumente und die Transkripte der Tonbänder — dieselbe Suche wie unter /media.
| Parameter | Bedeutung |
|---|---|
| q | Suchbegriff; leer lassen listet alles |
| gattung | dokument, bild, audio, video, tabelle, quelltext, archiv, sonstiges |
| quellenart | primaer, archiv, brief, sekundaer, presse, unbekannt |
| jahr_von, jahr_bis | Zeitraum eingrenzen |
| person | ID aus /api/personen |
| tag | ID aus /api/hashtags |
| limit, offset | Blättern; limit höchstens 200 |
{
"gesamt": 61,
"anzahl": 2,
"offset": 0,
"werke": [
{
"uuid": "7134c1a1-…",
"titel": "1955 Kontrabarie handschriftlich",
"gattung": "dokument",
"quellenart": "primaer",
"quellenart_klartext": "Primärquelle Heim",
"jahr": null,
"anriss": null,
"dateien": 2,
"personen_erfasst": null,
"personen_zugeordnet": 0,
"seite_url": "https://burkhardheim.de/media/w/7134c1a1-…",
"datei_url": "https://burkhardheim.de/media/f/…",
"vorschau_url": "https://burkhardheim.de/media/f/…"
}
]
}Liefert zusätzlich Beschreibung, Hashtags, zugeordnete Personen mit
Lebensdaten, alle zugehörigen Dateien mit Rolle, Größe, Maßen und Laufzeit
sowie eine Übersicht der vorhandenen Texte. Das Vorschaubild steht getrennt
als vorschau_url und nicht in der Dateiliste — es ist eine
erzeugte Miniatur, kein Bestandteil des Werks. Der Volltext selbst steht getrennt — bei
einem Buchscan wird er mehrere hundert Kilobyte groß.
Gibt den durchsuchbaren Text abschnittsweise zurück, mit Angabe der
Herkunft je Abschnitt: extraktion aus der Datei selbst,
ocr aus Texterkennung, transkript aus einer
Tonaufnahme. Das ist die Angabe, an der man erkennt, wie verlässlich der
Text ist — OCR und KI-Transkription sind fehlerbehaftet.
Getrennt seit dem 13.08.2026: /api/personen liefert die
73 Personen, /api/institutionen
die 13 Institutionen (DESY Hamburg,
Messerschmitt-Bölkow-Blohm, Stadtarchiv Northeim …). Zuvor gab eine einzige Adresse
beides gemischt aus und musste mit ?typ= eingeschränkt werden; dieser
Parameter entfällt. Beide liefern Lebensdaten, Rolle, Beschreibung, Wikipedia-Verweis,
die Zahl der Verbindungen im Netzwerk und die der zugeordneten Werke; mit
?q= wird nach Name oder Rolle gefiltert.
Das Beziehungsnetz als Ganzes: alle Knoten mit ihrer festen Lage auf der
Karte (x, y) und alle Kanten mit Begründung
(beziehung), Sicherheitsgrad (gesichert) und Quelle. Es sind
dieselben Koordinaten, aus denen Netzwerk & Chronik
gezeichnet wird — eine eigene Auswertung kommt damit zum selben Bild.
Die Zeittafel zu Leben und Werk, je Eintrag mit Quellenangabe. Einschränken mit
?jahr_von= und ?jahr_bis=.
Davon zu unterscheiden ist die Zuordnung zu einem Werk:
bislang 2. Sie entsteht erst beim Erschließen und
sagt, wer auf einem Bild zu sehen oder in einem Dokument genannt ist — sie ist es,
die /api/media?person=<id> beantwortet.
Alle vergebenen Hashtags mit der Zahl der Werke dahinter.
Die Linksammlung mit Notizen, Kategorien und Unterlinks.
Umfang des Archivs nach Gattung und Quellenart.
Die Adressen aus datei_url und url liefern die
Datei selbst. Audio und Video unterstützen Bereichsabrufe
(Range), sodass sich darin springen lässt, ohne alles zu laden.
Alte Adressen der Form /assets/<Datei> leiten dauerhaft
auf ihr neues Ziel weiter.
# Alle Tonbänder, in denen "Kontrabarie" vorkommt
curl -s "https://burkhardheim.de/api/media?q=kontrabarie&gattung=audio"
# Volltext des ersten Treffers
curl -s "https://burkhardheim.de/api/media?q=kontrabarie&limit=1" \
| python3 -c "import json,sys; print(json.load(sys.stdin)['werke'][0]['uuid'])"Fehlt eine Angabe, die Sie benötigen? Über einen Hinweis an info@burkhardheim.de freue ich mich.