Docs durchsuchen

Guides und API-Endpunkte durchsuchen

Referenz

Design-Regeln

Liefert das vollständige, aufgelöste Design-Token-Set des Kunden (Flächen-/Text-/Akzent-/Status-Farben, Typografie, Abstände, Komponenten). Diese Tokens werden beim Render in jedes MJML-Dokument injiziert und erzwingen ein konsistentes Erscheinungsbild über alle Newsletter hinweg. Das vollständige Regelwerk (welches Token wofür) steht unter /docs/design-rules.

Verfügbar
GET

/v1/design-rules

Gibt das vollständige, AUFGELÖSTE Token-Set des Kunden zurück: jeder {{token}} mit seinem konkreten Render-Wert (Größen wie Abstände/Breite bereits in px). Hat der Kunde noch keine eigenen Regeln hinterlegt, liefert die API vollständige Default-Tokens. Read-only, Scope reporting genügt — diese Tokens kann der Client nicht überschreiben, er kann sie nur lesen (z. B. für eine originalgetreue Editor-Vorschau).

Request · Next.js

const res = await fetch(`https://api.newsletterkit.ventureon.io/v1/design-rules`, {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.NEWSLETTERKIT_API_KEY}`,
    },
});
const data = await res.json();

Response 200

{
  "data": {
    "color_background": "#f4f4f5",
    "color_container": "#ffffff",
    "color_text": "#202020",
    "color_heading": "#111111",
    "color_primary": "#e11d48",
    "color_on_primary": "#ffffff",
    "color_link": "#2563eb",
    "color_footer_bg": "#1a1a1a",
    "color_footer_text": "#e4e4e7",
    "font_heading": "Georgia, serif",
    "font_body": "Helvetica, Arial, sans-serif",
    "font_size_base": "16px",
    "font_size_h1": "28px",
    "space_section": "16px",
    "container_width": "600",
    "button_radius": "6px"
  },
  "request_id": "…"
}

Design-Tokens werden serverseitig am Render injiziert — sie sind verbindlich und können über die API nicht verändert werden (Pflege im Admin-Dashboard). Das vollständige Regelwerk steht unter /docs/design-rules.