Previsualizar una plantilla
Exactamente el HTML que produciría un envío, sin enviarlo.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /templates/{id}/preview
Exactamente el HTML que produciría un envío, sin enviarlo.
Ejemplo
Necesita templates:read. Es un POST porque los valores van en un cuerpo; no se escribe nada y no se envía nada.
curl -X POST "$OE/templates/order-shipped/preview" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "version": 5, "props": { "orderId": "AC-4192" } }'{ "object": "template_preview", "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44", "version": 5, "subject": "Order AC-4192 is on its way", "html": "<!DOCTYPE html><html>…</html>", "text": "Hello there, AC-4192 is on its way.", "warnings": [{ "code": "unfilled_placeholder", "key": "customer" }]}Apunta tu CI aquí. Un cambio de plantilla que rompe tu integración pasa a ser un test que falla en lugar de un email confuso para un cliente.
Permisiva donde un envío es estricto: una prop obligatoria que falta se informa en warnings en lugar de rechazarse, porque una plantilla que se previsualiza suele ser una plantilla que se está escribiendo. Una prop DESCONOCIDA sigue siendo un 422 aquí, porque una errata es una errata en cualquier etapa.
Un borrador se puede previsualizar, y esta es la única ruta que renderiza algo fuera de publicar. Omite version y previsualizas lo que está publicado; nombra una para previsualizar esa revisión, borrador incluido.
JSON, nunca text/html. El HTML es una cadena dentro de un campo para que un cliente pueda parsear la respuesta antes de decidir qué hacer con ella.