Rechtstexte per API ausliefern: JSON vs. HTML-Fragment
Ein Vergleich der beiden Lieferformate der Public Delivery API und typische Einsatzszenarien.
Einleitung
Rechtlich relevante Website-Dokumente unterscheiden sich von gewöhnlichen Inhalten: Sie müssen nachvollziehbar gepflegt, kontrolliert freigegeben und zielgenau veröffentlicht werden. Der vorliegende Beitrag fasst bewährte Vorgehensweisen zusammen, ohne juristische Beratung zu ersetzen.
Kontext und Motivation
In vielen Organisationen entstehen Rechtstexte über lange Zeiträume in unterschiedlichen Werkzeugen. Word-Dokumente, CMS-Editoren, Snippets in Templates und kopierte Übersetzungen führen zu Setups, die schwer überblickbar sind. Spätestens beim Live-Abgleich zwischen freigegebener Fassung und tatsächlich ausgespielter Version zeigt sich, wo Lücken bestehen.
Ein zentraler, strukturierter Workflow reduziert diese Komplexität. Er bringt Authoring, Review, Freigabe, Veröffentlichung und Live-Prüfung in einen einheitlichen Rahmen — mit klaren Verantwortlichkeiten und vollständiger Historie.
Empfohlener Workflow
- Strukturen einrichten (Workspaces, Sites, Sprachen, Märkte).
- Dokumente strukturiert pflegen und Varianten gezielt definieren.
- Reviews sequentiell durchführen, Notizen dokumentieren.
- Freigaben als unveränderliche Snapshots fixieren.
- Veröffentlichungen zielgenau auf konkrete Targets auslösen.
- Live-Abgleich aktivieren und Findings nachhalten.
Typische Fallstricke
Häufige Probleme entstehen durch parallele Pflege in mehreren Systemen, fehlende Versionierung und unklare Zuständigkeiten. Auch automatische Übernahmen von Vorschlägen — etwa aus generierenden Werkzeugen — sollten vermieden werden. Änderungen sind grundsätzlich von Nutzenden zu prüfen und freizugeben.
Fazit
Strukturierte Pflege, nachvollziehbare Freigaben und kontrollierte Veröffentlichung sind die Grundlage für verlässliches Legal Content Management. Eine rechtliche Prüfung durch qualifizierte Beratung bleibt davon unberührt empfohlen.
TermShelf ausprobieren
Strukturen, Versionen und Veröffentlichungen in einem Workflow.
Verwandte Guides
Warum Rechtstexte nicht im CMS verstreut liegen sollten
Verteilte Rechtstexte in CMS-Seiten, Word-Dokumenten und kopierten Snippets erschweren Versionierung und Live-Abgleich. Der Beitrag zeigt typische Risiken.
Rechtstexte zentral verwalten: Versionierung, Freigabe und Veröffentlichung
Wie strukturierte Verwaltung, klare Reviews und kontrollierte Veröffentlichung das Management rechtlich relevanter Website-Inhalte vereinfachen.
Datenschutz, Impressum und AGB über mehrere Websites konsistent halten
Multi-Site- und Multi-Locale-Setups stellen besondere Anforderungen an Variantenpflege und Veröffentlichungskontrolle.