# MJML (alfa) API > Valida y renderiza MJML y consulta la referencia de MJML. En alfa, solo para el equipo de Emailit. URL base: `https://api.emailit.com/v2`. Autentícate con `Authorization: Bearer `. ## Validar MJML — POST /mjml/validate > Comprueba un MJML igual que al guardar una plantilla, sin guardarlo. Devuelve todos los diagnósticos con su línea. Alfa: solo para el equipo de Emailit. # Validar MJML Comprueba un MJML igual que al guardar una plantilla (sintaxis XML, estructura de MJML, tipos de los atributos y sintaxis de Temple) y lo compila con MJML 5.4.1. No se guarda nada. Un MJML no válido también devuelve `200`, con `valid: false` y los diagnósticos. Requiere el permiso `full`. Consulta [Validación](/es/docs/templates/mjml/#validation) para saber qué cubre cada comprobación. > **MJML está en alfa:** MJML solo está abierto al equipo de Emailit mientras lo probamos. Las demás peticiones, incluidas todas las que se hacen con una clave de API, devuelven `403` con `error: "mjml_alpha"`. Consulta [Quién puede usar MJML](/es/docs/templates/mjml/#who-can-use-mjml). `POST /mjml/validate` ## Parámetros del cuerpo - `source` (string | object, obligatorio): El MJML que se comprueba: marcado MJML (`…`), MJML JSON o un documento MJML de Emailit, como el `source` guardado de una plantilla. Consulta [Formatos de origen](/es/docs/templates/mjml/#source-formats). Como máximo, 2 MB. **Petición** `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 No válido** ```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 Válido** ```json { "valid": true, "mjml_version": "5.4.1", "format": "markup", "diagnostics": [] } ``` **200 No reconocido** ```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." } ``` ## Devuelve Devuelve `200 OK` con el resultado, aunque el MJML no sea válido: | Campo | Tipo | Descripción | | --- | --- | --- | | `valid` | booleano | `true` si no hay diagnósticos de error, es decir, si se puede guardar una plantilla con este origen. | | `mjml_version` | cadena | La versión de MJML con la que compila Emailit. | | `format` | cadena o null | Cómo se leyó el origen: `markup` o `json`. `null` si no se pudo leer. | | `diagnostics` | array | Todos los diagnósticos de error, de advertencia e informativos. | `valid: true` significa que una plantilla con este origen se aceptaría. Corrige también las advertencias: suelen señalar problemas reales, como que falte un ``. Para obtener el HTML, usa [Renderizar MJML](/es/docs/api-reference/mjml/render/). Devuelve `422` con `message: "Validation failed"` si falta `source` o está en blanco, y `403` con `error: "mjml_alpha"` sin acceso a MJML. ### Objeto de diagnóstico Los campos que no aplican se omiten. | Campo | Tipo | Descripción | | --- | --- | --- | | `severity` | cadena | `error`, `warning` o `info`. Solo los errores hacen que `valid` sea `false`. | | `code` | cadena | Un código estable, por ejemplo `mjml.invalid-child`, `xml.unclosed-tag` o `temple.unclosed-if`. Consulta [Códigos de diagnóstico](/es/docs/templates/mjml/#diagnostic-codes). | | `message` | cadena | Una explicación legible. | | `line` | entero | La línea en el marcado, empezando por 1. Solo en orígenes de marcado. | | `column` | entero | La columna en el marcado, empezando por 1. Solo en orígenes de marcado. | | `tag` | cadena | El elemento al que se refiere el diagnóstico. | | `attribute` | cadena | El atributo al que se refiere el diagnóstico. | | `path` | integer[] | La ruta de índices de hijos desde la raíz ``. | --- Fuente: https://emailit.com/es/docs/api-reference/mjml/validate/ ## Renderizar MJML — POST /mjml/render > Compila un MJML en el HTML que envía Emailit y previsualízalo con variables de Temple. Alfa: solo para el equipo de Emailit. # Renderizar MJML Compila un MJML en el HTML que envía Emailit, con MJML 5.4.1. Con `variables`, la respuesta también incluye `rendered_html`: el HTML después de aplicar Temple, tal como lo recibiría un destinatario. No se guarda ni se envía nada. Requiere el permiso `full`. Este endpoint está limitado a 120 peticiones por minuto. > **MJML está en alfa:** MJML solo está abierto al equipo de Emailit mientras lo probamos. Las demás peticiones, incluidas todas las que se hacen con una clave de API, devuelven `403` con `error: "mjml_alpha"`. Consulta [Quién puede usar MJML](/es/docs/templates/mjml/#who-can-use-mjml). `POST /mjml/render` ## Parámetros del cuerpo - `source` (string | object, obligatorio): El MJML que se compila: marcado MJML (`…`), MJML JSON o un documento MJML de Emailit, como el `source` guardado de una plantilla. Consulta [Formatos de origen](/es/docs/templates/mjml/#source-formats). Como máximo, 2 MB. - `variables` (object): Las variables de Temple para `rendered_html`, como `first_name`, o un objeto `cf` con los campos personalizados de la campaña. No se rellena nada automáticamente: pasa las variables que aportaría el canal de envío. Consulta [Variables por canal](/es/docs/templates/mjml/#variables-by-channel). Debe ser un objeto; cualquier otra cosa devuelve `400`. **Petición** `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 No válido** ```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." } ``` ## Devuelve Devuelve `200 OK` con el resultado, aunque el MJML no sea válido: | Campo | Tipo | Descripción | | --- | --- | --- | | `valid` | booleano | `true` si no hay diagnósticos de error. | | `mjml_version` | cadena | La versión de MJML con la que compila Emailit. | | `html` | cadena o null | El HTML compilado, con las etiquetas de Temple sin sustituir, tal como Emailit lo guarda para una plantilla. `null` si el MJML tiene errores. | | `html_bytes` | entero | El tamaño en UTF-8 de `html`. Gmail recorta los mensajes de más de unos 102 KB. `0` si `html` es `null`. | | `diagnostics` | array | Todos los diagnósticos de error, de advertencia e informativos. Consulta [Validar MJML](/es/docs/api-reference/mjml/validate/). | | `rendered_html` | cadena o null | `html` con las `variables` aplicadas por Temple. Solo aparece si envías `variables`, y es `null` si el MJML tiene errores. | Un MJML no válido devuelve `200` con `valid: false`, `html: null` y los diagnósticos. `rendered_html` usa exactamente las `variables` que envías: las variables que faltan se renderizan como cadenas vacías o como su valor por defecto, así que `{{first_name|"there"}}` se renderiza como `there`. El texto plano no se genera a partir del MJML. Devuelve `422` con `message: "Validation failed"` si falta `source` o está en blanco, `400` si `variables` no es un objeto, y `403` con `error: "mjml_alpha"` sin acceso a MJML. --- Fuente: https://emailit.com/es/docs/api-reference/mjml/render/ ## Obtener la referencia de MJML — GET /mjml/reference > Todos los componentes y atributos de MJML que admite Emailit, las versiones de los editores, la guía de Temple y las reglas de escritura. Alfa: solo para el equipo de Emailit. # Obtener la referencia de MJML Obtiene todos los componentes y atributos de la versión de MJML con la que compila Emailit, las versiones actuales de los editores, la guía de Temple y las reglas de escritura. Usa esta referencia para crear herramientas de desarrollo o para dar a un modelo de IA lo que necesita para escribir plantillas MJML válidas. Requiere el permiso `full`. La misma referencia está disponible para los agentes de IA como la herramienta MCP `get-mjml-reference`. Consulta [MJML para agentes de IA](/es/docs/templates/mjml/#mjml-for-ai-agents). > **MJML está en alfa:** MJML solo está abierto al equipo de Emailit mientras lo probamos. Las demás peticiones, incluidas todas las que se hacen con una clave de API, devuelven `403` con `error: "mjml_alpha"`. Consulta [Quién puede usar MJML](/es/docs/templates/mjml/#who-can-use-mjml). `GET /mjml/reference` **Petición** `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." } ``` ## Devuelve Devuelve `200 OK` con la referencia. El ejemplo de arriba está abreviado: `components` incluye los 36 componentes con todos sus atributos. | Campo | Tipo | Descripción | | --- | --- | --- | | `mjml_version` | cadena | La versión de MJML con la que compila Emailit. | | `document_schema_version` | entero | El `schema_version` actual del documento MJML guardado. | | `editors` | objeto | La versión y la fase actuales (`alpha`, `beta` o `stable`) de `mjml-code` y `mjml-visual`. | | `components` | array | Todos los componentes de MJML. Consulta más abajo. | | `temple_guide` | cadena | Cómo funciona Temple dentro de MJML: variables, valores por defecto, condicionales y variables de campaña. | | `rules` | cadena | Las reglas de escritura de MJML: estructura, atributos permitidos y accesibilidad. | | `reference_text` | cadena | Toda la referencia de componentes en texto plano compacto, para los prompts. | Devuelve `403` con `error: "mjml_alpha"` sin acceso a MJML. ### Objeto de componente | Campo | Tipo | Descripción | | --- | --- | --- | | `tag` | cadena | El nombre de la etiqueta, por ejemplo `mj-button`. | | `label` | cadena | El nombre visible. | | `description` | cadena | Lo que hace el componente. | | `category` | cadena | `root`, `head`, `layout`, `content`, `interactive`, `child` o `advanced`. | | `ending_tag` | booleano | `true` si el contenido es HTML o texto sin procesar (`mj-text`, `mj-button`, `mj-raw`, …). | | `parents` | string[] | Los elementos en los que se puede colocar este componente. | | `children` | string[] | Los elementos que puede contener este componente. `["*"]` significa cualquier componente (`mj-attributes`). | | `attributes` | array | Los atributos, cada uno con `name`, `type` (un tipo de MJML como `color`, `unit(px,%){1,4}` o `enum(left,center,right)`) y `default` (`null` si no hay ninguno). | --- Fuente: https://emailit.com/es/docs/api-reference/mjml/reference/