Pré-visualizar uma tradução

O que translate num envio produziria, sem nada enviado e sem nada guardado.

As mesmas três opções que um envio resolve, sem o envelope, passadas pela mesma função que o caminho de envio chama. Essa identidade é todo o valor do endpoint: uma pré-visualização com código próprio seria uma promessa que não cumprimos, e no dia em que as duas divergissem, aquilo que está no ecrã de alguém e aquilo que está na caixa de entrada do destinatário seriam diferentes sem nada que o dissesse.

A ida e volta que o compositor faz antes de mostrar a alguém aquilo que está prestes a 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}

O formato para que isto foi construído é pré-visualizar, EDITAR, enviar: mostre a tradução a uma pessoa, deixe-a alterá-la e depois envie o que ela aprovou como um html e um subject normais, sem translate nenhum no pedido. O que ela aprovou é então, palavra por palavra, aquilo que sai.

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>"  }'

• —Três chamadas ao modelo (o corpo, o assunto e uma para deduzir em que escreveu) emitidas em conjunto, pelo que a espera é a mais longa das três e não a soma delas. Indicar from dispensa a terceira. Custa o mesmo que enviar com translate, por isso pré-visualize uma vez em vez de a cada revisão.
• —Nada é enviado, nenhuma linha é escrita e nenhum id volta. Não há aqui nada para cancelar ou obter mais tarde.
• —Traduz e mais nada. Não revê o texto, não melhora a escrita e nunca responde à mensagem.
• —Nomes, empresas, ligações, números de encomenda, preços e datas voltam tal como entraram, para que a tradução possa ser conferida com o original linha a linha.
• —O histórico citado não é retirado, ao contrário do que acontece na metade da leitura. O que entregar é o que é traduzido, o que está certo para um compositor, onde o corpo é apenas o que alguém acabou de escrever, e é bom saber se publicar uma cadeia de respostas inteira.
• —Com o âmbito emails:send, sem âmbito próprio: não concede nada que um remetente já não pudesse fazer, e um âmbito que ninguém distingue de emails:send num ecrã de consentimento faz com que todos os outros âmbitos dessa lista signifiquem um pouco menos.