एक या अधिक कंपोनेंट स्कीमा से सभी प्रकाशित दस्तावेज़ों का लक्षित भाषाओं के समूह में बैकग्राउंड अनुवाद कतारबद्ध करें। प्रत्येक अनुवाद पूरा होने पर परिणाम translations तालिका में अपसर्ट किए जाते हैं।

एंडपॉइंट: POST /translation प्रमाणीकरण: Bearer JWT (WorkOS)

अनुरोध बॉडी

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

* schemaNames या schemaName में से कोई एक प्रदान करें।

केवल वे प्रकाशित दस्तावेज़ शामिल किए जाते हैं जिनकी प्रकाशित सामग्री null नहीं है।

प्रतिक्रिया

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

लौटाता है:

• 202 Accepted जब अनुवाद कतारबद्ध किए जाते हैं
• 200 OK जब प्रत्येक अनुवाद पहले से अद्यतन हो
• मौजूदा सक्रिय जॉब, जब समान अनुरोध पहले से चल रहा हो

संभावित जॉब स्थितियाँ हैं:

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

वर्तमान अनुवादों को छोड़ना

प्रत्येक दस्तावेज़-भाषा युग्म स्रोत दस्तावेज़ की प्रकाशित सामग्री का SHA-256 हैश संग्रहीत करता है।

जब संग्रहीत स्रोत हैश वर्तमान प्रकाशित सामग्री से मेल खाता है, तो अनुवाद छोड़ दिया जाता है। इससे बदली न गई सामग्री का दोबारा अनुवाद किए बिना एंडपॉइंट को बार-बार कॉल किया जा सकता है।

यदि कोई समतुल्य जॉब सक्रिय रहते हुए प्रकाशित सामग्री बदल जाती है, तो सेवा नए अनुरोध को अस्वीकार कर देती है। सक्रिय जॉब समाप्त होने के बाद इसे फिर से सबमिट करें।

प्रोसेसिंग व्यवहार

प्रारंभिक प्रतिक्रिया के बाद अनुवाद असिंक्रोनस रूप से चलता है।

• कार्य को सीमित समवर्तीता के साथ प्रोसेस किया जाता है।
• अस्थायी विफलताओं के लिए बैकऑफ के साथ पुनः प्रयास किया जाता है।
• सफल परिणामों को पूरा होते ही स्थायी रूप से सहेजा जाता है।
• अलग-अलग इन्फ़रेंस या स्थायित्व संबंधी विफलताएँ जॉब में दर्ज की जाती हैं।
• आंशिक रूप से सफल जॉब completed_with_errors स्थिति के साथ समाप्त होता है।

उदाहरण

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

त्रुटियाँ

• 400 Bad Request — स्कीमा या भाषाएँ अनुपस्थित हैं, कोई भाषा असमर्थित है, या बैच कॉन्फ़िगर की गई सीमा से अधिक है
• 401 Unauthorized — bearer token अनुपस्थित या अमान्य है
• 409 Conflict — मिलते-जुलते कार्य सक्रिय हैं, लेकिन प्रकाशित स्रोत सामग्री बदल गई है
• 500 Internal Server Error — स्रोत दस्तावेज़ तैयार नहीं किए जा सके या डेटाबेस ऑपरेशन विफल हुआ

अनुवाद जॉब प्राप्त करें

अनुवाद जॉब की नवीनतम प्रगति प्राप्त करें।

एंडपॉइंट: GET /translation-jobs/{job_id} प्रमाणीकरण: Bearer JWT (WorkOS)

प्रतिक्रिया

प्रतिक्रिया में POST /translation द्वारा लौटाई गई वही जॉब ऑब्जेक्ट होती है, जिसमें अद्यतन स्थिति और प्रगति गणनाएँ होती हैं।

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

उदाहरण

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

त्रुटियाँ

• 401 Unauthorized — bearer token अनुपस्थित या अमान्य है
• 404 Not Found — जॉब मौजूद नहीं है या अब सुरक्षित नहीं रखा गया है

अनुवाद जॉब वर्तमान में मेमोरी में रखे जाते हैं। अनुवाद सेवा के पुनः प्रारंभ होने पर जॉब की स्थिति खो जाती है, और बहु-इंस्टेंस परिनियोजन के लिए स्टिकी रूटिंग आवश्यक है।