# MJML (Alpha) API > MJML validieren und rendern und die MJML-Referenz lesen. In der Alpha und nur für das Emailit-Team zugänglich. Basis-URL: `https://api.emailit.com/v2`. Authentifizieren Sie sich mit `Authorization: Bearer `. ## MJML validieren — POST /mjml/validate > Prüfen Sie MJML wie beim Speichern einer Vorlage, ohne es zu speichern. Gibt jede Diagnose mit ihrer Zeile zurück. Alpha: nur für das Emailit-Team zugänglich. # MJML validieren Prüft MJML wie beim Speichern einer Vorlage (XML-Syntax, MJML-Struktur, Attributtypen und Temple-Syntax) und kompiliert es mit MJML 5.4.1. Es wird nichts gespeichert. Ungültiges MJML gibt trotzdem `200` zurück, mit `valid: false` und den Diagnosen. Erfordert den Scope `full`. Was die einzelnen Prüfungen abdecken, erfahren Sie unter [Validierung](/de/docs/templates/mjml/#validation). > **MJML ist in der Alpha:** MJML steht nur dem Emailit-Team offen, solange wir es testen. Andere Anfragen, auch jede Anfrage mit einem API-Schlüssel, geben `403` mit `error: "mjml_alpha"` zurück. Siehe [Wer MJML nutzen kann](/de/docs/templates/mjml/#who-can-use-mjml). `POST /mjml/validate` ## Body-Parameter - `source` (string | object, erforderlich): Das zu prüfende MJML: MJML-Markup (`…`), MJML-JSON oder ein Emailit-MJML-Dokument, etwa das gespeicherte `source` einer Vorlage. Siehe [Quellformate](/de/docs/templates/mjml/#source-formats). Höchstens 2 MB. **Anfrage** `POST /mjml/validate` **Node.js** ```javascript const source = ` Hi {{first_name}} `; const response = await fetch('https://api.emailit.com/v2/mjml/validate', { method: 'POST', headers: { 'Authorization': 'Bearer your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ source }) }); const { valid, diagnostics } = await response.json(); ``` **cURL** ```bash curl -X POST https://api.emailit.com/v2/mjml/validate \ -H "Authorization: Bearer your_api_key" \ -H "Content-Type: application/json" \ -d '{ "source": "\n \n \n Hi {{first_name}}\n \n \n" }' ``` **200 Ungültig** ```json { "valid": false, "mjml_version": "5.4.1", "format": "markup", "diagnostics": [ { "severity": "error", "code": "mjml.invalid-child", "message": " cannot be placed inside . Allowed parents: , .", "line": 3, "column": 6, "tag": "mj-column", "path": [0, 0] }, { "severity": "error", "code": "mjml.unknown-attribute", "message": " has no attribute colour. Did you mean color?", "line": 4, "column": 16, "tag": "mj-text", "attribute": "colour", "path": [0, 0, 0] }, { "severity": "warning", "code": "mjml.missing-title", "message": "Add an to ; clients and screen readers use it.", "line": 1, "column": 2, "tag": "mjml", "path": [] }, { "severity": "info", "code": "mjml.missing-preview", "message": "Add an to control the inbox preview text.", "line": 1, "column": 2, "tag": "mjml", "path": [] } ] } ``` **200 Gültig** ```json { "valid": true, "mjml_version": "5.4.1", "format": "markup", "diagnostics": [] } ``` **200 Nicht erkannt** ```json { "valid": false, "mjml_version": "5.4.1", "format": null, "diagnostics": [ { "severity": "error", "code": "document.unrecognized", "message": "Expected MJML markup (…), MJML JSON or an Emailit MJML document." } ] } ``` **422** ```json { "message": "Validation failed", "errors": { "source": ["The source field is required."] } } ``` **403** ```json { "error": "mjml_alpha", "message": "MJML is in alpha and available only to Emailit platform admins." } ``` ## Rückgabe Gibt `200 OK` mit dem Ergebnis zurück, auch wenn das MJML ungültig ist: | Feld | Typ | Beschreibung | | --- | --- | --- | | `valid` | boolean | `true`, wenn es keine Fehlerdiagnosen gibt, sich eine Vorlage mit dieser Quelle also speichern lässt. | | `mjml_version` | string | Die MJML-Version, mit der Emailit kompiliert. | | `format` | string oder null | Wie die Quelle gelesen wurde: `markup` oder `json`. `null`, wenn sie nicht gelesen werden konnte. | | `diagnostics` | array | Alle Diagnosen der Stufen Fehler, Warnung und Info. | `valid: true` bedeutet, dass eine Vorlage mit dieser Quelle angenommen würde. Beheben Sie auch die Warnungen: Sie weisen meist auf echte Probleme hin, etwa ein fehlendes ``. Das HTML erhalten Sie mit [MJML rendern](/de/docs/api-reference/mjml/render/). Gibt `422` mit `message: "Validation failed"` zurück, wenn `source` fehlt oder leer ist, und `403` mit `error: "mjml_alpha"` ohne MJML-Zugriff. ### Diagnose-Objekt Felder, die nicht zutreffen, werden weggelassen. | Feld | Typ | Beschreibung | | --- | --- | --- | | `severity` | string | `error`, `warning` oder `info`. Nur Fehler setzen `valid` auf false. | | `code` | string | Ein stabiler Code, zum Beispiel `mjml.invalid-child`, `xml.unclosed-tag` oder `temple.unclosed-if`. Siehe [Diagnosecodes](/de/docs/templates/mjml/#diagnostic-codes). | | `message` | string | Eine verständliche Erklärung. | | `line` | integer | Zeile im Markup, ab 1 gezählt. Nur bei Markup-Quellen. | | `column` | integer | Spalte im Markup, ab 1 gezählt. Nur bei Markup-Quellen. | | `tag` | string | Das Element, auf das sich die Diagnose bezieht. | | `attribute` | string | Das Attribut, auf das sich die Diagnose bezieht. | | `path` | integer[] | Pfad aus Kindindizes ab der Wurzel ``. | --- Quelle: https://emailit.com/de/docs/api-reference/mjml/validate/ ## MJML rendern — POST /mjml/render > Kompilieren Sie MJML zu dem HTML, das Emailit sendet, und sehen Sie es sich mit Temple-Variablen in der Vorschau an. Alpha: nur für das Emailit-Team zugänglich. # MJML rendern Kompiliert MJML mit MJML 5.4.1 zu dem HTML, das Emailit sendet. Mit `variables` enthält die Antwort außerdem `rendered_html`: das HTML, nachdem Temple angewendet wurde, so wie ein einzelner Empfänger es erhalten würde. Es wird nichts gespeichert oder gesendet. Erfordert den Scope `full`. Dieser Endpunkt ist auf 120 Anfragen pro Minute begrenzt. > **MJML ist in der Alpha:** MJML steht nur dem Emailit-Team offen, solange wir es testen. Andere Anfragen, auch jede Anfrage mit einem API-Schlüssel, geben `403` mit `error: "mjml_alpha"` zurück. Siehe [Wer MJML nutzen kann](/de/docs/templates/mjml/#who-can-use-mjml). `POST /mjml/render` ## Body-Parameter - `source` (string | object, erforderlich): Das zu kompilierende MJML: MJML-Markup (`…`), MJML-JSON oder ein Emailit-MJML-Dokument, etwa das gespeicherte `source` einer Vorlage. Siehe [Quellformate](/de/docs/templates/mjml/#source-formats). Höchstens 2 MB. - `variables` (object): Temple-Variablen für `rendered_html`, etwa `first_name`, oder ein Objekt `cf` mit eigenen Feldern für Kampagnen. Nichts wird automatisch befüllt: Übergeben Sie die Variablen, die der sendende Kanal liefern würde. Siehe [Variablen nach Kanal](/de/docs/templates/mjml/#variables-by-channel). Muss ein Objekt sein; alles andere gibt `400` zurück. **Anfrage** `POST /mjml/render` **Node.js** ```javascript const source = ` Welcome Your account is ready Hi {{first_name|"there"}}, welcome aboard. Activate account `; const response = await fetch('https://api.emailit.com/v2/mjml/render', { method: 'POST', headers: { 'Authorization': 'Bearer your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ source, variables: { first_name: 'Ada', activation_url: 'https://example.com/activate?token=abc123' } }) }); const { html, rendered_html } = await response.json(); ``` **cURL** ```bash curl -X POST https://api.emailit.com/v2/mjml/render \ -H "Authorization: Bearer your_api_key" \ -H "Content-Type: application/json" \ -d '{ "source": "WelcomeYour account is readyHi {{first_name|\"there\"}}, welcome aboard.Activate account", "variables": { "first_name": "Ada", "activation_url": "https://example.com/activate?token=abc123" } }' ``` **200** ```json { "valid": true, "mjml_version": "5.4.1", "html": "\n…Hi {{first_name|\"there\"}}, welcome aboard.……\n", "html_bytes": 5267, "diagnostics": [], "rendered_html": "\n…Hi Ada, welcome aboard.……\n" } ``` **200 Ungültig** ```json { "valid": false, "mjml_version": "5.4.1", "html": null, "html_bytes": 0, "diagnostics": [ { "severity": "error", "code": "mjml.invalid-child", "message": " cannot be placed inside . Allowed parents: , .", "line": 3, "column": 6, "tag": "mj-column", "path": [0, 0] }, { "severity": "error", "code": "mjml.unknown-attribute", "message": " has no attribute colour. Did you mean color?", "line": 4, "column": 16, "tag": "mj-text", "attribute": "colour", "path": [0, 0, 0] }, { "severity": "warning", "code": "mjml.missing-title", "message": "Add an to ; clients and screen readers use it.", "line": 1, "column": 2, "tag": "mjml", "path": [] }, { "severity": "info", "code": "mjml.missing-preview", "message": "Add an to control the inbox preview text.", "line": 1, "column": 2, "tag": "mjml", "path": [] } ], "rendered_html": null } ``` **422** ```json { "message": "Validation failed", "errors": { "source": ["The source field is required."] } } ``` **403** ```json { "error": "mjml_alpha", "message": "MJML is in alpha and available only to Emailit platform admins." } ``` ## Rückgabe Gibt `200 OK` mit dem Ergebnis zurück, auch wenn das MJML ungültig ist: | Feld | Typ | Beschreibung | | --- | --- | --- | | `valid` | boolean | `true`, wenn es keine Fehlerdiagnosen gibt. | | `mjml_version` | string | Die MJML-Version, mit der Emailit kompiliert. | | `html` | string oder null | Das kompilierte HTML mit unveränderten Temple-Tags, so wie Emailit es für eine Vorlage speichert. `null`, wenn das MJML Fehler enthält. | | `html_bytes` | integer | UTF-8-Größe von `html`. Gmail kürzt Nachrichten ab etwa 102 KB. `0`, wenn `html` `null` ist. | | `diagnostics` | array | Alle Diagnosen der Stufen Fehler, Warnung und Info. Siehe [MJML validieren](/de/docs/api-reference/mjml/validate/). | | `rendered_html` | string oder null | `html`, nachdem Temple die `variables` angewendet hat. Nur vorhanden, wenn Sie `variables` senden, und `null`, wenn das MJML Fehler enthält. | Ungültiges MJML gibt `200` mit `valid: false`, `html: null` und den Diagnosen zurück. `rendered_html` verwendet genau die `variables`, die Sie senden: Fehlende Variablen werden als leere Strings oder als ihr Standardwert gerendert, `{{first_name|"there"}}` ergibt also `there`. Aus MJML wird kein Nur-Text erzeugt. Gibt `422` mit `message: "Validation failed"` zurück, wenn `source` fehlt oder leer ist, `400`, wenn `variables` kein Objekt ist, und `403` mit `error: "mjml_alpha"` ohne MJML-Zugriff. --- Quelle: https://emailit.com/de/docs/api-reference/mjml/render/ ## MJML-Referenz abrufen — GET /mjml/reference > Alle MJML-Komponenten und -Attribute, die Emailit unterstützt, die Editor-Versionen, der Temple-Leitfaden und Regeln zum Verfassen von MJML. Alpha: nur für das Emailit-Team zugänglich. # MJML-Referenz abrufen Ruft alle MJML-Komponenten und -Attribute der MJML-Version ab, mit der Emailit kompiliert, dazu die aktuellen Editor-Versionen, den Temple-Leitfaden und die Regeln zum Verfassen von MJML. Damit können Sie Tools entwickeln oder einem KI-Modell geben, was es zum Schreiben gültiger MJML-Vorlagen braucht. Erfordert den Scope `full`. Dieselbe Referenz steht KI-Agenten als MCP-Tool `get-mjml-reference` zur Verfügung. Siehe [MJML für KI-Agenten](/de/docs/templates/mjml/#mjml-for-ai-agents). > **MJML ist in der Alpha:** MJML steht nur dem Emailit-Team offen, solange wir es testen. Andere Anfragen, auch jede Anfrage mit einem API-Schlüssel, geben `403` mit `error: "mjml_alpha"` zurück. Siehe [Wer MJML nutzen kann](/de/docs/templates/mjml/#who-can-use-mjml). `GET /mjml/reference` **Anfrage** `GET /mjml/reference` **Node.js** ```javascript const response = await fetch('https://api.emailit.com/v2/mjml/reference', { headers: { 'Authorization': 'Bearer your_api_key' } }); const reference = await response.json(); ``` **cURL** ```bash curl https://api.emailit.com/v2/mjml/reference \ -H "Authorization: Bearer your_api_key" ``` **200** ```json { "mjml_version": "5.4.1", "document_schema_version": 1, "editors": { "mjml-code": { "version": "0.2.0", "stage": "alpha" }, "mjml-visual": { "version": "0.2.0", "stage": "alpha" } }, "components": [ { "tag": "mj-body", "label": "Body", "description": "The visible email. Holds sections, wrappers and heroes.", "category": "root", "ending_tag": false, "parents": ["mjml"], "children": ["mj-raw", "mj-section", "mj-wrapper", "mj-hero"], "attributes": [ { "name": "width", "type": "unit(px)", "default": "600px" }, { "name": "background-color", "type": "color", "default": null }, { "name": "id", "type": "string", "default": null }, { "name": "mj-class", "type": "string", "default": null }, { "name": "css-class", "type": "string", "default": null } ] }, { "tag": "mj-button", "label": "Button", "description": "A bulletproof call-to-action button. Content is the label.", "category": "content", "ending_tag": true, "parents": ["mj-column", "mj-hero"], "children": [], "attributes": [ { "name": "align", "type": "enum(left,center,right)", "default": "center" }, { "name": "background-color", "type": "color", "default": "#414141" }, { "name": "href", "type": "string", "default": null }, { "name": "inner-padding", "type": "unit(px,%){1,4}", "default": "10px 25px" } ] } ], "temple_guide": "Temple is Emailit's templating language, evaluated per recipient at send time on the final HTML:\n- {{first_name}} inserts a variable; …", "rules": "MJML rules:\n- Structure: > (optional) + . …", "reference_text": "MJML 5.4.1 component reference. Format: name=type[default]. …" } ``` **403** ```json { "error": "mjml_alpha", "message": "MJML is in alpha and available only to Emailit platform admins." } ``` ## Rückgabe Gibt `200 OK` mit der Referenz zurück. Das Beispiel oben ist gekürzt: `components` listet alle 36 Komponenten mit allen ihren Attributen auf. | Feld | Typ | Beschreibung | | --- | --- | --- | | `mjml_version` | string | Die MJML-Version, mit der Emailit kompiliert. | | `document_schema_version` | integer | Die aktuelle `schema_version` des gespeicherten MJML-Dokuments. | | `editors` | object | Aktuelle Version und Stufe (`alpha`, `beta` oder `stable`) von `mjml-code` und `mjml-visual`. | | `components` | array | Alle MJML-Komponenten. Siehe unten. | | `temple_guide` | string | Wie Temple in MJML funktioniert: Variablen, Standardwerte, Bedingungen und Kampagnenvariablen. | | `rules` | string | Regeln zum Verfassen von MJML: Struktur, erlaubte Attribute und Barrierefreiheit. | | `reference_text` | string | Die gesamte Komponentenreferenz als kompakter Nur-Text, für Prompts. | Gibt ohne MJML-Zugriff `403` mit `error: "mjml_alpha"` zurück. ### Komponenten-Objekt | Feld | Typ | Beschreibung | | --- | --- | --- | | `tag` | string | Tag-Name, zum Beispiel `mj-button`. | | `label` | string | Anzeigename. | | `description` | string | Was die Komponente tut. | | `category` | string | `root`, `head`, `layout`, `content`, `interactive`, `child` oder `advanced`. | | `ending_tag` | boolean | `true`, wenn der Inhalt rohes HTML oder Text ist (`mj-text`, `mj-button`, `mj-raw`, …). | | `parents` | string[] | Elemente, in die diese Komponente gesetzt werden kann. | | `children` | string[] | Elemente, die diese Komponente enthalten kann. `["*"]` bedeutet jede beliebige Komponente (`mj-attributes`). | | `attributes` | array | Attribute, jeweils mit `name`, `type` (ein MJML-Typ wie `color`, `unit(px,%){1,4}` oder `enum(left,center,right)`) und `default` (`null`, wenn es keinen gibt). | --- Quelle: https://emailit.com/de/docs/api-reference/mjml/reference/