Pāriet uz dokumentāciju
API

Priekšskatīt tulkojumu

Ko `translate` sūtījumā izgatavotu — neko nenosūtot un neko nesaglabājot.

POSTapi.openemail.uk/emails/translate

Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.

POST /emails/translate

Ko translate sūtījumā izgatavotu — neko nenosūtot un neko nesaglabājot.

Pieprasījums

Tās pašas trīs opcijas, ko atrisina sūtījums, bez aploksnes, izlaistas caur to pašu funkciju, ko izsauc sūtīšanas ceļš. Šis identiskums ir visa galapunkta vērtība: priekšskatījums ar savu atsevišķu kodu būtu solījums, ko mēs neturam, un dienā, kad abi izietu no sinhrona, tas, kas ir uz kāda ekrāna, un tas, kas ir saņēmēja iesūtnē, atšķirtos, un nekas to nepateiktu.

Parametri

tostringobligāts
Valoda, kurā rakstīt. BCP-47 kods (`de`), nosaukums angliski ("German") vai pašas valodas nosaukums ("Deutsch"). Atbilde pasaka, uz kuru kodu tas tika atrisināts, un tieši šī forma ir jāglabā, ja uzturat valodu katram kontaktam.
htmlstring
HTML pamatteksts, līdz vienam megabaitam. Ir nepieciešams viens no html, text vai subject.
textstring
Vienkāršā teksta daļa. Tulkota neatkarīgi no `html`, ar savu garuma pārbaudi.
subjectstring
Temata RINDA: virkne, nevis būla vērtība, kāda tā ir zem `translate` sūtījumā. Tie ir divi dažādi jautājumi: tur jūs sakāt, vai tulkot tematu, kas mums jau ir, bet šeit jūs to iedodat.
fromstring
Valoda, kurā rakstījāt, jebkurā no tām pašām trim formām. Tās norādīšana ļauj izlaist noteikšanas izsaukumu.
includeOriginalboolean
Vai atgrieztais `html` jau nes jūsu oriģinālu zem tulkojuma. Noklusējums ir true.

Nezināmas atslēgas ir 422, tāpat kā visur citur. Pieprasījums, kurā nav neviena no html, text vai subject, ir 422 uz html: "One of html, text or subject is required".

Priekšskatiet to

Brauciens, ko redaktors veic, pirms parādīt cilvēkam to, ko viņš gatavojas nosūtīt.

curl
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"  }'
Atbilde
{  "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}

html, text un subject laukam, ko nenosūtījāt, atgriežas kā null, nevis vispār trūkst, tāpēc klients var attēlot atbildi, neatceroties, ko tas prasīja.

detectedSourceLanguage ir null, kad noteikšana atturējās. Tā ir īsta atbilde, nevis kļūme. Pamatteksts no vārdiem, skaitļiem un saitēm tai neko nedod, ko lasīt, un vienīgās sekas ir tādas, ka jūsu oriģināla paraksts ir bez valodas.

includeOriginal tiek atkārtots atbildē, jo tas maina to, kas ir html. Ja tas ir ieslēgts, pamatteksts jau nes jūsu oriģinālu zem tulkojuma, un savas kopijas pievienošana to nosūta divreiz.

Priekšskatīt, rediģēt, nosūtīt

Tas ir paredzēts secībai priekšskatīt, REDIĢĒT, nosūtīt: parādiet cilvēkam tulkojumu, ļaujiet viņam to mainīt, tad nosūtiet apstiprināto kā parastu html un subject bez jebkāda translate pieprasījumā. Tas, ko viņš apstiprināja, tad vārds vārdā ir tas, kas aiziet.

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

Sūtīšana ar translate pēc priekšskatīšanas tulko otrreiz un izmet labojumus. Sūtījums aizietu ar formulējumu, ko neviens nav lasījis — tieši to vienu kļūmi priekšskatījums pastāv, lai novērstu.

Ko tas maksā un ko tas nedara

  • Trīs modeļa izsaukumi (pamatteksts, temats un viens, lai noskaidrotu, kādā valodā rakstījāt) tiek izdoti kopā, tāpēc gaidīšana ir garākais no trim, nevis to summa. from norādīšana atmet trešo. Tās ir tās pašas izmaksas kā sūtīšanai ar translate, tāpēc priekšskatiet vienreiz, nevis pie katras labojumu kārtas.
  • Nekas netiek nosūtīts, netiek ierakstīta neviena rinda, un id neatgriežas. Šeit nav nekā, ko vēlāk atcelt vai izgūt.
  • Tas tulko un neko citu nedara. Tas nekoriģē, neuzlabo rakstību un nekad neatbild uz ziņojumu.
  • Vārdi, uzņēmumi, saites, pasūtījumu numuri, cenas un datumi atgriežas tādi, kādi iegāja, tāpēc tulkojumu var pārbaudīt pret oriģinālu rindu pa rindai.
  • Citētā vēsture netiek izgriezta, atšķirībā no lasīšanas puses. Tulkots tiek tas, ko iedodat, un tas ir pareizi redaktoram, kur pamatteksts ir tikai tas, ko kāds tikko uzrakstīja; to ir vērts zināt, ja nosūtāt visu atbilžu ķēdi.
  • Tvērums ir emails:send, sava tvēruma nav: tas nepiešķir neko, ko sūtītājs jau tāpat nevarētu darīt, un tvērums, kuru piekrišanas ekrānā neviens nevar atšķirt no emails:send, padara katru citu tvērumu šajā sarakstā mazliet mazāk nozīmīgu.

Pamatteksts ir ierobežots ar to pašu megabaitu, ko atļauj sūtījums, taču pats tulkojums atsaka jebko virs 30 000 rakstzīmēm ar translation_too_long. Kļūmju kodi ir tie paši, ko atgriež tulkots sūtījums; tie uzskaitīti sadaļā Nosūtīt e-pastu.