Developers

Deliver legal content where it's needed.

Published content is available via the Public Delivery API as JSON or sanitized HTML fragments. App API access is available as a separate feature from the Business plan onward.

Public Delivery API

Read-only. Fast. Cache-friendly.

The Public Delivery API serves only already-published content. Write operations and unpublished drafts are not reachable through this interface.

Fetch JSON

Structured format with sections, blocks, and metadata.

Embed HTML fragment

Sanitized HTML fragments for direct embedding in existing pages.

Use ETag

Cache-friendly responses with ETag and matching headers.

Pin a version

Request and lock specific versions deliberately.

Example

Fetch the published privacy document.

Simplified example calls — not a live backend integration.

JSON
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": [ /* … */ ]
}
HTML fragment
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 access

A separate interface, available from Business.

App API access exposes functionality for workspaces, documents, and operational flows. It's clearly separated from the Public Delivery API and available from the Business plan onward.

  • Management of workspaces, sites, and locales
  • Documents, versions, and reviews
  • Publications and targets
  • Scanner jobs and findings
  • Token-based authentication

Auth

Token-based authentication scoped to a workspace.

Webhooks

Signed, replayable delivery of publication events.

Publish, deliver, integrate.

TermShelf brings the Public Delivery API and app functions into a clear framework.

Developers — TermShelf