Podgląd tłumaczenia

Co wyprodukowałoby translate przy wysyłce, przy czym nic nie jest wysyłane ani zapisywane.

Te same trzy opcje, które rozwiązuje wysyłka, bez koperty, przepuszczone przez tę samą funkcję, którą wywołuje ścieżka wysyłki. Ta tożsamość jest całą wartością tego endpointu: podgląd z własnym kodem byłby obietnicą, której nie dotrzymujemy, a w dniu, w którym te dwie rzeczy by się rozjechały, to, co widać na czyimś ekranie, i to, co trafia do skrzynki odbiorcy, różniłyby się, i nic by o tym nie powiedziało.

Podróż w obie strony, którą kompozytor wykonuje, zanim pokaże komuś, co zaraz wyśle.

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}

Kształt, pod który to zbudowano, to podgląd, EDYCJA, wysyłka: pokaż człowiekowi tłumaczenie, pozwól mu je zmienić, a potem wyślij to, co zatwierdził, jako zwykłe html i subject, bez translate w żądaniu w ogóle. To, co zatwierdził, wychodzi wtedy słowo w słowo.

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

• —Trzy wywołania modelu (treść, temat i jedno po to, by ustalić, w czym napisałeś) wydawane razem, więc czekanie jest najdłuższym z tych trzech, a nie ich sumą. Podanie from usuwa trzecie. Kosztuje to tyle samo co wysyłka z translate, więc podglądaj raz, a nie przy każdej poprawce.
• —Nic nie jest wysyłane, żaden wiersz nie jest zapisywany i nie wraca żaden identyfikator. Nie ma tu nic, co dałoby się później anulować albo pobrać.
• —Tłumaczy i nie robi nic więcej. Nie robi korekty, nie poprawia stylu i nigdy nie odpowiada na wiadomość.
• —Nazwiska, firmy, odnośniki, numery zamówień, ceny i daty wracają w takiej postaci, w jakiej weszły, więc tłumaczenie da się sprawdzić z oryginałem wiersz po wierszu.
• —Cytowana historia nie jest usuwana, inaczej niż po stronie odczytu. Tłumaczone jest to, co przekażesz, co jest właściwe dla kompozytora, gdzie treścią jest tylko to, co ktoś właśnie napisał, i warto o tym wiedzieć, jeśli wysyłasz cały łańcuch odpowiedzi.
• —Objęte zakresem emails:send, bez własnego zakresu: nie daje nic, czego nadawca nie mógłby już zrobić, a zakres, którego nikt nie odróżni od emails:send na ekranie zgody, sprawia, że każdy inny zakres na tej liście znaczy trochę mniej.