API

Çeviriyi önizleme

Bir gönderimdeki `translate` alanının neyi üreteceğini gösterir; hiçbir şey gönderilmeden ve saklanmadan.

POSTapi.openemail.uk/emails/translate

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

POST /emails/translate

Bir gönderimdeki translate alanının neyi üreteceğini gösterir; hiçbir şey gönderilmeden ve saklanmadan.

İstek

Bir gönderimin çözdüğü aynı üç seçenek, zarf olmadan, gönderim yolunun çağırdığı işlevin aynısından geçirilir. Bu özdeşlik uç noktanın bütün değeridir: kendi koduna sahip bir önizleme, tutmadığımız bir söz olurdu ve ikisinin ayrıştığı gün, birinin ekranındaki şeyle alıcının gelen kutusundaki şey, bunu söyleyecek hiçbir şey olmadan farklılaşırdı.

Parametreler

tostringzorunlu: Yazılacak dil. BCP-47 bir kod (`de`), İngilizce bir ad ("German") ya da dilin kendi adı ("Deutsch"). Yanıt hangi koda çözdüğünü size söyler; kişi başına bir dil saklıyorsanız saklamanız gereken biçim budur.
htmlstring: HTML gövde, en çok bir megabayt. html, text ya da subject alanlarından biri zorunludur.
textstring: Düz metin bölümü. `html` alanından bağımsız olarak, kendi uzunluk denetimiyle çevrilir.
subjectstring: Konu SATIRI: bir dize; bir gönderimde `translate` altında olduğu gibi bir boole değil. İkisi farklı sorulardır: orada elimizde bulunan bir konunun çevrilip çevrilmeyeceğini söylüyorsunuz, burada ise bir konuyu siz veriyorsunuz.
fromstring: Metni hangi dilde yazdığınız, aynı üç biçimden herhangi biriyle. Belirtmek, saptama çağrısını atlar.
includeOriginalboolean: Döndürülen `html` içeriğinin, çevirinin altında özgün metninizi taşıyıp taşımayacağı. Varsayılanı true'dur.

Bilinmeyen anahtarlar, her yerde olduğu gibi 422 verir. html, text ve subject alanlarının hiçbirini taşımayan bir istek html üzerinde 422 verir: "One of html, text or subject is required".

Önizleme

Yazma penceresinin, birine göndermek üzere olduğu şeyi göstermeden önce yaptığı gidiş dönüş.

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

Yanıt

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

Göndermediğiniz bir alan için html, text ve subject yok sayılmak yerine null olarak döner; böylece bir istemci ne sorduğunu hatırlamadan yanıtı gösterebilir.

Saptama çekimser kaldığında detectedSourceLanguage null olur. Bu bir başarısızlık değil, gerçek bir yanıttır. Adlardan, sayılardan ve bağlantılardan oluşan bir gövde ona okuyacak bir şey vermez ve tek sonucu, özgün metninizin başlığında bir dilin anılmamasıdır.

includeOriginal geri yansıtılır, çünkü html içeriğinin ne taşıdığını değiştirir. Açıkken gövde, çevirinin altında zaten özgün metninizi taşır; kendi kopyanızı eklemek onu iki kez göndermek olur.

Önizle, düzenle, gönder

Bu uç noktanın kurulduğu biçim şudur: önizle, DÜZENLE, gönder. Birine çeviriyi gösterin, değiştirmesine izin verin, sonra onayladığını istekte hiç translate olmadan sıradan bir html ve subject olarak gönderin. O zaman onayladıkları, kelimesi kelimesine giden şey olur.

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

Önizlemeden sonra translate ile göndermek ikinci kez çevirir ve düzenlemeleri çöpe atar. Gönderim, kimsenin okumadığı bir metinle çıkardı; oysa önizlemenin var olma nedeni tam olarak bu başarısızlığı önlemektir.

Maliyeti ve yapmadıkları

Birlikte gönderilen üç model çağrısı (gövde, konu ve metni neyle yazdığınızı belirlemek için bir tane), yani bekleme süresi bunların toplamı değil en uzunudur. from belirtmek üçüncüsünü ortadan kaldırır. Maliyeti translate ile göndermekle aynıdır; bu yüzden her düzeltmede değil, bir kez önizleyin.
Hiçbir şey gönderilmez, hiçbir satır yazılmaz ve geriye bir id dönmez. Burada sonradan iptal edilecek ya da getirilecek bir şey yoktur.
Yalnızca çevirir, başka bir şey yapmaz. Metni düzeltmez, yazıyı iyileştirmez ve iletiyi asla yanıtlamaz.
Adlar, şirketler, bağlantılar, sipariş numaraları, fiyatlar ve tarihler girdikleri gibi geri gelir; böylece çeviri, özgün metinle satır satır karşılaştırılabilir.
Okuma tarafının aksine alıntılanmış geçmiş ayıklanmaz. Verdiğiniz şey çevrilir; bu, gövdenin yalnızca birinin az önce yazdığı şey olduğu bir yazma penceresi için doğrudur ve bütün bir yanıt zincirini gönderiyorsanız bilmeye değer.
emails:send kapsamındadır, kendine ait bir kapsamı yoktur: bir göndericinin zaten yapamayacağı hiçbir şeye izin vermez ve bir onay ekranında emails:send kapsamından ayırt edilemeyen bir kapsam, o listedeki diğer her kapsamı biraz daha anlamsızlaştırır.

Gövde, bir gönderimin izin verdiği aynı megabaytla sınırlıdır; ama çevirinin kendisi 30.000 karakteri aşan her şeyi translation_too_long ile reddeder. Hata kodları, çevrilmiş bir gönderimin döndürdükleriyle aynıdır ve E-posta gönderme sayfasında listelenmiştir.