API üzerinden Markdown belgesi yerelleştirme

content_type: "markdown" ve hedef dillerinizle birlikte POST /documents isteği gönderin. Transept, dokümanı bloklara ayırır ve her hedef dil için birer dil versiyonu oluşturur.

Ardından Transept'i API ile otomatikleştirin kısmındaki gibi maliyet tahmini yapıp işlemi çalıştırın; bu işlem tek bir çağrıyla tüm dil versiyonlarına 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": "Getting started", "content_type": "markdown", "source_language": "en",
       "target_languages": ["de", "fr"],
       "content": "# Getting started\n\nInstall the app, then…"}'
# → { document_id, language_group: [ {id, target_language}, … ] }

Her bir dil versiyonu için GET /documents/{id}/content?format=markdown çağrısı, yapısı korunmuş şekilde oluşturulmuş markdown içeriğini döndürür. Diğer formatlar (blok bazlı okumalar için json, docx, pdf, xliff, csv), Transept'i API ile otomatikleştirin sayfasındaki format tablosunda listelenmiştir.

curl -s "$BASE/documents/<de-version-id>/content?format=markdown" \
  -H "Authorization: Bearer $KEY"

Kaynak metin daha sonra değiştiğinde, yeniden içe aktarmak yerine yeniden hizalayın: POST /documents/{id}/resync-source değişmeyen blokları (ve çevirilerini) korur, değişen veya eklenen blokları ise güncelliğini yitirmiş olarak işaretler; yalnızca güncellenenler (only-updated) davranışı ile yapılan bir çalıştırma ise sadece bu bloklara dokunur. Bu özellik, API üzerinden bir dize kataloğunu yerelleştirme bölümündeki anahtarlı deltanın düz metin tarafındaki karşılığıdır; genel işleyiş Yalnızca değişenleri çalıştır başlığı altında anlatılmıştır.

# the source changed? re-align, then run only what went stale
curl -s -X POST $BASE/documents/<master>/resync-source \
  -H "Authorization: Bearer $KEY"