Kalo te dokumentacioni
API

Parapamje e një përkthimi

Çfarë do të prodhonte `translate` te një dërgim, pa u dërguar dhe pa u ruajtur asgjë.

POSTapi.openemail.uk/emails/translate

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

POST /emails/translate

Çfarë do të prodhonte translate te një dërgim, pa u dërguar dhe pa u ruajtur asgjë.

Kërkesa

Të njëjtat tri opsione që zgjidh një dërgim, pa zarfin, të kaluara përmes të njëjtit funksion që thërret rruga e dërgimit. Ky identitet është e gjithë vlera e këtij endpoint-i: një parapamje me kod të vetin do të ishte një premtim që nuk e mbajmë, dhe ditën që të dyja do të largoheshin nga njëra-tjetra, ajo që është në ekranin e dikujt dhe ajo që mbërrin në kutinë e marrësit do të ndryshonin pa asnjë shenjë që ta thoshte.

Parametrat

tostringe detyrueshme
Gjuha në të cilën do të shkruhet. Një kod BCP-47 (`de`), një emër anglisht («German») ose emri që gjuha i jep vetes («Deutsch»). Përgjigjja ju thotë te cili kod u zgjidh, dhe kjo është forma që duhet ruajtur nëse po mbani një gjuhë për çdo kontakt.
htmlstring
Trupi HTML, deri në një megabajt. Kërkohet njëra prej html, text ose subject.
textstring
Pjesa me tekst të thjeshtë. Përkthehet në mënyrë të pavarur nga `html`, me kontrollin e vet të gjatësisë.
subjectstring
RRESHTI i subjektit: një varg, jo vlera boolean që është nën `translate` te një dërgim. Të dyja janë pyetje të ndryshme: atje po thoni nëse duhet përkthyer një subjekt që e kemi tashmë, këtu po dorëzoni një të tillë.
fromstring
Gjuha në të cilën e shkruat ju, në cilëndo nga të njëjtat tri forma. Deklarimi i saj e kursen thirrjen e zbulimit.
includeOriginalboolean
Nëse `html` i kthyer e mbart tashmë origjinalin tuaj poshtë përkthimit. Si parazgjedhje true.

Çelësat e panjohur janë një 422, si kudo tjetër. Një kërkesë pa asnjërën prej html, text ose subject është një 422 mbi html: «One of html, text or subject is required».

Shiheni paraprakisht

Udhëtimi që bën kompozuesi para se t’i tregojë dikujt çfarë është gati të dërgojë.

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"  }'
Përgjigje
{  "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 dhe subject kthehen si null e jo si të munguara për një fushë që nuk e dërguat, që një klient ta renderojë përgjigjen pa e mbajtur mend se çfarë kërkoi.

detectedSourceLanguage është null kur zbulimi u përmbajt. Kjo është përgjigje e vërtetë e jo dështim. Një trup me emra, numra dhe lidhje nuk i jep asgjë për të lexuar, dhe pasoja e vetme është se origjinali juaj titullohet pa një gjuhë.

includeOriginal kthehet si jehonë sepse ndryshon atë që përmban html. Me të të ndezur, trupi e mbart tashmë origjinalin tuaj poshtë përkthimit, dhe shtimi i një kopjeje tuajën e dërgon atë dy herë.

Parapamje, redaktim, dërgim

Forma për të cilën është ndërtuar kjo është: parapamje, REDAKTIM, dërgim — tregojini një personi përkthimin, lëreni ta ndryshojë, pastaj dërgoni atë që ai miratoi si një html dhe subject të zakonshëm, pa asnjë translate te kërkesa. Ajo që ai miratoi është atëherë fjalë për fjalë ajo që niset.

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

Dërgimi me translate pas parapamjes përkthen për herë të dytë dhe i hedh tutje redaktimet. Dërgimi do të nisej me një formulim që nuk e ka lexuar askush — pikërisht dështimi i vetëm që parapamja ekziston për ta parandaluar.

Sa kushton dhe çfarë nuk bën

  • Tri thirrje modeli (trupi, subjekti dhe një për të përcaktuar në ç’gjuhë shkruat) nisen bashkë, kështu që pritja është më e gjata e të trijave e jo shuma e tyre. Deklarimi i from e heq të tretën. Kushton njësoj sa dërgimi me translate, ndaj bëni një parapamje të vetme e jo një për çdo rishikim.
  • Nuk dërgohet asgjë, nuk shkruhet asnjë rresht dhe nuk kthehet asnjë id. Këtu nuk ka asgjë për ta anuluar apo për ta marrë më vonë.
  • Ai vetëm përkthen dhe asgjë tjetër. Nuk bën korrekturë, nuk e përmirëson shkrimin dhe nuk i përgjigjet kurrë mesazhit.
  • Emrat, kompanitë, lidhjet, numrat e porosive, çmimet dhe datat kthehen ashtu siç hynë, që përkthimi të mund të krahasohet me origjinalin rresht për rresht.
  • Historiku i cituar nuk hiqet, ndryshe nga gjysma e leximit. Ajo që dorëzoni është ajo që përkthehet, gjë që është e drejtë për një kompozues, ku trupi është vetëm ajo që sapo shkroi dikush, dhe ia vlen ta dini nëse dërgoni një zinxhir të tërë përgjigjesh.
  • Me fushëveprimin emails:send dhe pa një fushëveprim të vetin: nuk jep asgjë që një dërgues nuk mund ta bënte tashmë, dhe një fushëveprim që askush nuk e dallon dot nga emails:send në një ekran pëlqimi e bën çdo fushëveprim tjetër në atë listë pak më pak kuptimplotë.

Trupi kufizohet te i njëjti megabajt që lejon një dërgim, por vetë përkthimi refuzon çdo gjë mbi 30.000 karaktere me translation_too_long. Kodet e dështimit janë ato që kthen një dërgim i përkthyer, të listuara te «Dërgoni një email».