Inhaltstypen & Einträge

Ein Inhaltstyp ist die Form, die Inhalte annehmen: welche Felder es gibt, wie sie heißen und was hineindarf. Ein Eintrag ist ein Datensatz genau eines Inhaltstyps — ein Blogbeitrag, ein Produkt, eine Person. Inhaltstypen entstehen im Klick-Baukasten unter Inhaltstypen, ohne YAML, ohne TypoScript, ohne Migration.

Inhaltstyp anlegen

Ein Inhaltstyp hat einen Namen, einen Slug und Felder. Der Slug ist der API-Name: er taucht in den URLs der Delivery API auf (/delivery/content/{slug}). Er lässt sich später ändern, dann müssen aber alle Abfragen im Frontend nachgezogen werden.

Empfehlung: lieber wenige, klare Typen. Zwei Typen mit je acht Feldern sind leichter zu pflegen als einer mit zwanzig optionalen Feldern.

Feldtypen

Jedes Feld hat einen Schlüssel (key), unter dem der Wert in data erscheint, sowie Pflicht, Hilfetext und Vorgabewert.

Gruppen

Felder lassen sich in Gruppen ordnen — „Stammdaten", „Beschreibung", „SEO". Gruppen strukturieren nur die Eingabemaske; in der API bleiben alle Felder flach unter data. Für wiederholbare Strukturen (etwa eine Liste von Öffnungszeiten) eignet sich ein JSON-Feld mit Schema oder ein eigener Inhaltstyp mit Relation.

Relationen

Eine Relation verweist auf einen oder mehrere Einträge eines anderen Typs: ein Beitrag hat einen Autor (Person), ein Produkt gehört zu einer Kategorie. In der API steht standardmäßig nur die ID; mit expand=relations wird der verknüpfte Eintrag mitgeliefert:

curl "https://entrydeck.app/api/v1/delivery/content/beitrag/relaunch-2026?locale=de&expand=relations,media" \
  -H "x-api-key: $ENTRYDECK_API_KEY"

{
  "id": "…",
  "slug": "relaunch-2026",
  "locale": "de",
  "data": {
    "title": "Relaunch 2026",
    "author": { "id": "…", "slug": "manuel-grasse", "data": { "name": "Manuel Grasse" } },
    "hero": { "id": "…", "url": "https://…/hero-large.webp", "alt": "…", "width": 1600, "height": 900 }
  },
  "seo": { "title": "…", "canonical": "https://muster.de/blog/relaunch-2026", "jsonLd": [ … ] }
}

Relationen werden beim Import über den Content-Mapper ebenfalls aufgelöst — anhand des Schlüssels in der Quelle.

Sprachen

Als übersetzbar markierte Felder existieren je Sprache; alles andere gilt für alle Sprachen gemeinsam. Gespeichert wird je Sprache: Der Sprachumschalter im Editor wechselt die Übersetzung, ungespeicherte Änderungen bleiben beim Wechsel erhalten. Fehlt eine Übersetzung, liefert die API die Standardsprache der Website.

Slug und SEO je Eintrag

Der Slug wird aus dem Titel vorgeschlagen und danach nicht mehr automatisch geändert — sonst brächen veröffentlichte Links. Rechts im Editor stehen die SEO-Felder: Titel, Beschreibung, Bild, Canonical, noindex, Keywords, Open Graph. Die Delivery API baut daraus ein fertiges SEO-Objekt mit JSON-LD.

Status und Workflow

Wer welchen Übergang gehen darf, steuern Rollen und Rechte je Inhaltstyp (etwa content.publish). Jede Änderung landet im Änderungsprotokoll unter Audit-Log, mit Vorher/Nachher der geänderten Felder.

Zuweisung an Websites

Ein Eintrag wird einer oder mehreren Websites zugewiesen. Nur zugewiesene und veröffentlichte Einträge erscheinen in der API der jeweiligen Website. So bleibt ein Standort auf der Hauptseite und der Karriereseite identisch, ohne kopiert zu werden.

Listen und Filter

Die Liste unter Inhalte filtert nach Typ, Status und Sprache; Suche, Filter und Sortierung stehen in der Adresszeile und lassen sich als Link weitergeben. ⌘ K öffnet die Befehlspalette mit Volltextsuche über alle Einträge.