Previsualizar una traducción

Lo que produciría translate en un envío, sin enviar nada ni almacenar nada.

Las mismas tres opciones que resuelve un envío, menos el sobre, pasadas por la misma función que invoca la ruta de envío. Esa identidad es todo el valor del endpoint: una vista previa con código propio sería una promesa que no cumplimos, y el día en que ambas divergieran, lo que aparece en la pantalla de alguien y lo que llega a la bandeja del destinatario serían distintos sin nada que lo advirtiera.

El viaje de ida y vuelta que hace el redactor antes de mostrarle a alguien lo que está a punto de enviar.

curl -X POST "$OE/emails/translate" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "subject": "Your September invoice",    "html": "<p>Invoice attached. Payment is due on the 14th.</p>",    "to": "de"  }'

{  "object": "translation",  "language": { "code": "de", "label": "German", "native": "Deutsch", "flag": "🇩🇪", "rtl": false },  "detectedSourceLanguage": {    "code": "en", "label": "English", "native": "English", "flag": "🇬🇧", "rtl": false  },  "subject": "Ihre Rechnung für September",  "html": "<p>Rechnung im Anhang. Zahlbar bis zum 14.</p>\n<div style=\"margin:28px 0 0;padding:14px 0 0;border-top:1px solid #d6dae0\">\n<div style=\"margin:0 0 10px;font-size:12px;line-height:1.5;color:#6b7280\">Ursprüngliche Nachricht (English)</div>\n<div><p>Invoice attached. Payment is due on the 14th.</p></div>\n</div>",  "text": null,  "includeOriginal": true}

La forma para la que está pensado es previsualizar, EDITAR, enviar: muéstrale la traducción a una persona, deja que la modifique y luego envía lo que aprobó como un html y un subject normales, sin ningún translate en la solicitud. Lo que aprobó es entonces, palabra por palabra, lo que sale.

curl -X POST "$OE/emails" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "from": "[email protected]",    "to": ["[email protected]"],    "subject": "Ihre Rechnung für September",    "html": "<p>Rechnung im Anhang. Zahlbar bis zum 14.</p>"  }'

• —Tres llamadas al modelo (el cuerpo, el asunto y una para averiguar en qué idioma escribiste) emitidas a la vez, así que la espera es la más larga de las tres y no su suma. Indicar from elimina la tercera. Cuesta lo mismo que enviar con translate, así que previsualiza una vez y no en cada revisión.
• —No se envía nada, no se escribe ninguna fila y no se devuelve ningún id. Aquí no hay nada que cancelar ni recuperar después.
• —Traduce y no hace nada más. No corrige, no mejora la redacción y nunca responde al mensaje.
• —Los nombres, las empresas, los enlaces, los números de pedido, los precios y las fechas vuelven tal como entraron, de modo que la traducción se puede cotejar con el original línea por línea.
• —El historial citado no se elimina, a diferencia de lo que ocurre en la parte de lectura. Lo que entregas es lo que se traduce, lo cual es correcto para un redactor, donde el cuerpo es solo lo que alguien acaba de escribir, y conviene tenerlo en cuenta si envías una cadena de respuestas completa.
• —Requiere el scope emails:send y no tiene uno propio: no concede nada que un remitente no pudiera hacer ya, y un scope que nadie distingue de emails:send en una pantalla de consentimiento hace que todos los demás scopes de esa lista signifiquen un poco menos.