Entwickler
Rechtstexte dort ausliefern, wo sie gebraucht werden.
Veröffentlichte Inhalte stehen über die Public Delivery API als JSON oder als sanitisierte HTML-Fragmente bereit. App-API-Zugang ist als separate Funktion ab dem Business-Plan verfügbar.
Public Delivery API
Read-only. Schnell. Cache-freundlich.
Die Public Delivery API liefert ausschließlich bereits veröffentlichte Inhalte. Schreibvorgänge oder unveröffentlichte Entwürfe sind über diese Schnittstelle nicht erreichbar.
JSON abrufen
Strukturiertes Format mit Abschnitten, Blöcken und Metadaten.
HTML-Fragment einbetten
Sanitisierte HTML-Fragmente für direkte Einbindung in bestehende Seiten.
ETag nutzen
Caching-fähige Antworten mit ETag und passenden Headern.
Version pinnen
Bestimmte Versionen gezielt anfragen und festhalten.
Beispiel
Veröffentlichten Datenschutz abrufen.
Vereinfachte Beispiel-Aufrufe — keine echte Backend-Integration.
GET https://api.termshelf.de/v1/documents/datenschutz
?site=acme-de
&locale=de
&version=4.2.0
Headers:
Accept: application/json
If-None-Match: W/"a1f2c-v4.2.0"
200 OK
ETag: W/"a1f2c-v4.2.0"
Cache-Control: public, max-age=300
{
"document": "datenschutz",
"version": "4.2.0",
"locale": "de",
"site": "acme-de",
"sections": [ /* … */ ]
}GET https://api.termshelf.de/v1/documents/datenschutz/html
?site=acme-de
&locale=de
Headers:
Accept: text/html
200 OK
ETag: W/"a1f2c-v4.2.0"
Cache-Control: public, max-age=300
<section data-doc="datenschutz" data-version="4.2.0">
<h2>Verantwortlicher</h2>
<p>…</p>
</section>App API-Zugang
Separate Schnittstelle ab Business.
Der App-API-Zugang stellt Funktionen für Workspaces, Dokumente und operative Abläufe bereit. Er ist klar von der Public Delivery API getrennt und ab dem Business-Plan verfügbar.
- Verwaltung von Workspaces, Sites und Locales
- Dokumente, Versionen und Reviews
- Veröffentlichungen und Targets
- Scanner-Aufträge und Findings
- Token-basierte Authentifizierung
Auth
Token-basierte Authentifizierung mit Workspace-Bezug.
Webhooks
Signierte, replayable Zustellung von Publikationsereignissen.
Veröffentlichen, ausliefern, integrieren.
TermShelf bringt Public Delivery API und App-Funktionen in einen klaren Rahmen.