Glossar

Glossar: Legal Content Operations von A bis Z.

Kompakte, neutrale Definitionen der zentralen TermShelf-Begriffe — von Legal Content Drift über die Public Delivery API bis zum Version Pinning. Jeder Eintrag verlinkt auf die passende Feature- oder Guide-Seite.

Public Delivery API
Die Public Delivery API ist die read-only Auslieferungs-Schnittstelle von TermShelf für bereits veröffentlichte Rechtstexte. Sie gibt eine freigegebene Dokumentversion als sanitisiertes HTML-Fragment, als strukturiertes JSON oder als PDF-Artefakt zurück und unterstützt Version Pinning, effective_at sowie ETag-Caching. Schreibvorgänge und unveröffentlichte Entwürfe sind über sie nicht erreichbar.
Version Pinning
Version Pinning bezeichnet das gezielte Anfragen einer bestimmten freigegebenen Fassung über die Public Delivery API, etwa per Parameter ?version=N. Statt immer die aktuell live Fassung zu liefern, gibt die API genau die referenzierte Version zurück. Weicht sie von der live-Version ab, antwortet sie mit Status 409 und nennt die aktuell live Version. Das ist die Grundlage für stabile Referenzen und Nachweis.
effective_at / stichtagsbezogene Auslieferung
Die stichtagsbezogene Auslieferung über den Parameter effective_at gibt die Rechtstext-Fassung zurück, die zu einem bestimmten Zeitpunkt live war — angefragt als ISO-8601-Datum. Sie ist planabhängig verfügbar und relevant, wenn nicht die aktuelle, sondern die zu einem Stichtag gültige Version benötigt wird, etwa für Nachweis-Szenarien rund um einen Vertragsschluss.
ETag & Caching
Ein ETag ist eine Kennung, die die Public Delivery API mit jeder Antwort mitsendet und die eine konkrete ausgelieferte Fassung identifiziert. Konsumierende Systeme können sie bei der nächsten Anfrage über If-None-Match mitschicken; ist der Inhalt unverändert, antwortet die API mit 304 Not Modified statt mit dem vollständigen Inhalt. Zusammen mit Cache-Control ermöglicht das eine effiziente, cache-freundliche Einbindung von Rechtstexten.
Rechtstext-Versionierung
Rechtstext-Versionierung bezeichnet das kontrollierte Führen von Fassungen eines Rechtstextes über seinen Lebenszyklus: Entwurf, Review, Freigabe und Veröffentlichung. Jede veröffentlichte Version ist ein unveränderlicher Snapshot mit Versionsnummer und Datum. Wiederherstellungen erzeugen neue Entwürfe, statt Historie zu überschreiben. Dadurch bleibt nachvollziehbar, welche Fassung wann freigegeben und live war.
Immutable Snapshot
Ein Immutable Snapshot ist die unveränderliche Momentaufnahme eines Rechtstextes, die bei der Freigabe einer Version entsteht. Sie trägt eine Versionsnummer und ein Datum und wird nach der Veröffentlichung nicht mehr verändert. Spätere Anpassungen entstehen als neue Entwürfe und Versionen, sodass die Historie vollständig erhalten bleibt. Snapshots sind die Grundlage für Version Pinning, Auslieferung und Live-Abgleich.
HTML-Fragment
Ein HTML-Fragment ist eine der drei Artefaktformen der Public Delivery API: sanitisiertes HTML einer veröffentlichten Rechtstext-Fassung, das sich direkt in Websites, Apps, Footer oder transaktionale E-Mails einbetten lässt. Es enthält strukturierte Abschnitte mit stabilen Schlüsseln und Metadaten wie der Dokumentversion, ohne dass Volltexte kopiert werden müssen.
PDF-Artefakt
Ein PDF-Artefakt ist die PDF-Form einer veröffentlichten Rechtstext-Fassung, die über die Public Delivery API abgerufen wird. Es eignet sich als Anhang für Bestell-, Vertrags- oder Registrierungsmails. Da es aus genau der freigegebenen Version stammt, bleibt — bei gespeicherter Versionsnummer — nachvollziehbar, welche Fassung einer Transaktion beilag.
Legal Text Finding / Drift Finding
Ein Drift Finding (Legal Text Finding) ist ein bearbeitbarer Vorgang, den der Live-Abgleich erzeugt, wenn die live sichtbare Fassung eines Rechtstextes von der freigegebenen Version abweicht. Findings werden pro Site, Sprache und Markt ausgewiesen und lassen sich öffnen, zuweisen und bearbeiten. So wird Drift zu einer nachvollziehbaren Aufgabe statt zu einem Zufallsfund.
Site Profile
Ein Site Profile (Website-Profil) bildet eine kommerzielle oder funktionale Ausprägung einer Site ab, etwa B2C oder B2B. Es ist eines der Ziele, für die ein Rechtstext veröffentlicht und über die Public Delivery API abgerufen werden kann — neben Site, Domain, Locale und Markt. Profile ermöglichen gezielte Varianten, ohne ein Dokument zu duplizieren.
Override
Ein Override ist eine gezielte Abweichung von einem Basisdokument für ein bestimmtes Ziel — etwa eine Sprache, einen Markt, ein Site Profile oder eine Marke. Statt ganze Dokumente zu kopieren, werden geerbte Inhaltsblöcke nur dort ersetzt oder unterdrückt, wo sie tatsächlich abweichen. So bleiben gemeinsame Passagen an einer Quelle und driften nicht auseinander.

Begriffe verstanden — jetzt anwenden.

Bring deine Rechtstexte in einen strukturierten Lebenszyklus aus Versionierung, Auslieferung und Live-Abgleich.

Glossar — Legal Content Operations Begriffe | TermShelf