API üzerinden e-posta şablonu yerelleştirme

Hedef dillerinizi ve content_type: "html" parametresini belirterek POST /documents isteği yapın. HTML olduğu gibi aktarılır; biçimlendirme, bağlantılar ve şablon yer tutucularının tamamı çeviri sürecinde korunur.

Ardından, Transept'i API ile Otomatikleştirin bölümünde olduğu gibi maliyet tahmini yapın ve işlemi başlatın: Tahmin ücretsizdir ve işlem, tek bir çağrıyla tüm dil versiyonlarına aynı anda uygulanır.

# BASE="https://app.transept.ai/api/public/v1"; KEY from Settings → Developer
curl -s -X POST $BASE/documents \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Trial welcome", "content_type": "html", "source_language": "en",
       "target_languages": ["de", "fr"],
       "content": "<h1>Welcome, {{ first_name | default:\"friend\" }}!</h1><p>Your trial starts today.</p>"}'
# → { document_id, language_group: [ {id, target_language}, … ] }

{{ first_name | … }} yapısı, model metni görmeden önce maskelenir ve işlemden sonra olduğu gibi geri yüklenir; yanıt kaynak metinle karşılaştırıldığı için kaybolan veya bozulan belirteçler o haliyle sunulmak yerine onarılır. Bilinçli bir istisna şudur: Etiket içindeki yedek metinler (default:"friend" içindeki friend gibi), sistemde adı kayıtlı olmayan alıcıların doğrudan okuduğu kısımlardır; bu nedenle etiketin kendisi korunurken bu metin çevrilir. Belirteç koruma kurallarının tamamı strings dosyaları sayfasında yer almaktadır.

Her bir dil versiyonu için GET /documents/{id}/content?format=html çağrısı, çevrilmiş metni içeren aynı HTML yapısını döndürür; bu içerik ESP'nin ilgili dil varyantına yapıştırılmaya hazırdır.

curl -s "$BASE/documents/<de-version-id>/content?format=html" \
  -H "Authorization: Bearer $KEY"
# → the same HTML with German copy, Liquid intact

Evet. “the request body is the content” olarak ayarlanmış bir webhook tetikleyicisi, şablonu doğrudan ESP'nizden veya bir Zapier/n8n adımından alır, ulaştığı anda iş akışını başlatır; çeviriler hazır olduğunda ise giden bir webhook imzalı bir olay iletir. Böylece otomasyonunuz, sürekli sorgulama yapmaya gerek kalmadan HTML'i geri alabilir. Kimsenin manuel olarak bir şey yüklemesi gerekmez.