Yayımlanmış tüm belgelerin bir veya daha fazla bileşen şemasından bir dizi hedef dile arka planda çevrilmesini kuyruğa alır. Çeviriler tamamlandıkça sonuçlar translations tablosuna eklenir veya güncellenir.

Uç nokta: POST /translation Kimlik doğrulama: Bearer JWT (WorkOS)

İstek gövdesi

{
  "websiteId": "<uuid>",
  "schemaNames": ["post", "hero"],
  "languages": ["fr", "es", "de"]
}

* schemaNames veya schemaName seçeneklerinden birini sağlayın.

Yalnızca yayımlanmış içeriği null olmayan yayımlanmış belgeler değerlendirilir.

Yanıt

{
  "job_id": "<uuid>",
  "website_id": "<uuid>",
  "schema_name": null,
  "schema_names": ["post", "hero"],
  "languages": ["fr", "es", "de"],
  "status": "queued",
  "documents_processed": 12,
  "translations_scheduled": 30,
  "translations_skipped": 6,
  "translations_completed": 0,
  "translations_failed": 0,
  "reused": false,
  "created_at": "2026-07-15T18:00:00Z",
  "updated_at": "2026-07-15T18:00:00Z"
}

Şunları döndürür:

• Çeviriler kuyruğa alındığında 202 Accepted
• Her çeviri zaten güncelse 200 OK
• Aynı istek zaten çalışıyorsa mevcut etkin iş

Olası iş durumları:

• preparing
• queued
• running
• completed
• completed_with_errors
• failed

Güncel çevirileri atlama

Her belge-dil çifti, kaynak belgenin yayımlanmış içeriğinin SHA-256 özetini saklar.

Saklanan kaynak özeti mevcut yayımlanmış içerikle eşleştiğinde çeviri atlanır. Bu, uç noktanın değişmemiş içeriği yeniden çevirmeden tekrar tekrar çağrılabilmesini sağlar.

Eşdeğer bir iş etkin durumdayken yayımlanmış içerik değişirse hizmet yeni isteği reddeder. Etkin iş tamamlandıktan sonra isteği yeniden gönderin.

İşleme davranışı

Çeviri, ilk yanıttan sonra eşzamansız olarak çalışır.

• İşler sınırlı eşzamanlılıkla işlenir.
• Geçici hatalar, geri çekilme aralığı uygulanarak yeniden denenir.
• Başarılı sonuçlar tamamlandıkça kalıcı olarak kaydedilir.
• Tek tek çıkarım veya kalıcılaştırma hataları iş üzerine kaydedilir.
• Kısmen başarılı bir iş completed_with_errors durumuyla tamamlanır.

Örnek

curl -X POST '{TRANSLATION_API_URL}/translation' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{
    "websiteId": "<uuid>",
    "schemaNames": ["post", "hero"],
    "languages": ["fr", "es"]
  }'

Hatalar

• 400 Bad Request — şemalar veya diller eksik, bir dil desteklenmiyor ya da toplu işlem yapılandırılmış sınırı aşıyor
• 401 Unauthorized — bearer belirteci eksik veya geçersiz
• 409 Conflict — eşleşen iş etkin, ancak yayımlanmış kaynak içerik değişti
• 500 Internal Server Error — kaynak belgeler hazırlanamadı veya bir veritabanı işlemi başarısız oldu

Çeviri işini al

Bir çeviri işinin en güncel ilerleme durumunu alır.

Uç nokta: GET /translation-jobs/{job_id} Kimlik doğrulama: Bearer JWT (WorkOS)

Yanıt

Yanıt, güncellenmiş durum ve ilerleme sayaçlarıyla birlikte POST /translation tarafından döndürülen iş nesnesinin aynısını kullanır.

{
  "job_id": "<uuid>",
  "website_id": "<uuid>",
  "schema_name": null,
  "schema_names": ["post", "hero"],
  "languages": ["fr", "es"],
  "status": "running",
  "documents_processed": 12,
  "translations_scheduled": 24,
  "translations_skipped": 0,
  "translations_completed": 16,
  "translations_failed": 1,
  "reused": false,
  "created_at": "2026-07-15T18:00:00Z",
  "updated_at": "2026-07-15T18:01:30Z"
}

Örnek

curl '{TRANSLATION_API_URL}/translation-jobs/<job-id>' \
  -H 'Authorization: Bearer <workos-jwt>'

Hatalar

• 401 Unauthorized — bearer belirteci eksik veya geçersiz
• 404 Not Found — iş mevcut değil veya artık saklanmıyor

Çeviri işleri şu anda bellekte saklanmaktadır. Çeviri hizmeti yeniden başlatıldığında iş durumu kaybolur ve birden çok örnek içeren dağıtımlarda yapışkan yönlendirme gerekir.