Ein sinnvolles Eingabeschema für Vorlagen entwerfen
Verständliche Eingaben für Text, Zahl, Boolean, Farbe und Medien bereitstellen, ohne Ebeneninterna offenzulegen.
Eine Vorlage ist ein normales JsonCut-Projekt mit einem bewusst kleinen öffentlichen Eingabeschema. Das beste Schema beschreibt, was der Nutzer ändern will – nicht, wie der Editor es speichert.
Das Ergebnis benennen
Nimm lieber Headline, Produktbild und Angebot als interne Ebenen-IDs. Füge ein Beispiel hinzu und markiere eine Eingabe nur dann als Pflicht, wenn das Design ohne sie wirklich nicht funktioniert.
Typen bewusst klein halten
Nutze Text, Zahl, Boolean, Farbe, Bild, Video oder Audio. Ein kompaktes Typsystem macht Formulare, CSV-Zuordnung, API-Validierung und Erstellung per Agent verständlicher.
Erst prüfen, dann befüllen
Hol dir das Eingabeschema der Vorlage, bevor du Werte sendest. So bleibt eine Integration aktuell, auch wenn eine spätere Vorlagenversion optionale Felder ergänzt.
GET /api/v2/templates/{templateId}/inputs
POST /api/v2/templates/{templateId}/renders