पैच अनुवाद

मौजूदा अनुवाद की संग्रहीत सामग्री को मैन्युअल रूप से बदलें। मशीन द्वारा जनित आउटपुट को पूरे दस्तावेज़ का पुनः अनुवाद किए बिना ठीक करने की आवश्यकता होने पर इसका उपयोग करें।

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

अनुरोध बॉडी

{
  "document_id": "<uuid>",
  "language": "fr",
  "content": {
    "title": "Bonjour",
    "body": "..."
  }
}

document_id और language का संयोजन अनुवाद पंक्ति की पहचान करता है।

प्रत्युत्तर

{
  "document_id": "<uuid>",
  "language": "fr",
  "updated": true
}

स्रोत-हैश का व्यवहार

अनुवाद को मैन्युअल रूप से अद्यतन करने से उसका source_hash नहीं बदलता।

फलस्वरूप:

• यदि स्रोत दस्तावेज़ में परिवर्तन नहीं हुआ है, तो बाद का POST /translation अनुवाद को छोड़ देता है और मैन्युअल सुधार को सुरक्षित रखता है
• यदि स्रोत दस्तावेज़ बदल जाता है, तो उसका हैश अब मेल नहीं खाता और बाद का अनुवाद जॉब मैन्युअल रूप से सुधारी गई सामग्री को पुनः उत्पन्न करके अधिलेखित कर सकता है

उदाहरण

curl -X PATCH '{TRANSLATION_API_URL}/translations' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{
    "document_id": "<uuid>",
    "language": "fr",
    "content": {
      "title": "Bonjour",
      "body": "Contenu corrigé."
    }
  }'

त्रुटियाँ

• 400 Bad Request — content एक JSON ऑब्जेक्ट नहीं है
• 401 Unauthorized — बेयरर टोकन अनुपस्थित है या अवैध है
• 404 Not Found — दिए गए document_id और language के लिए कोई अनुवाद मौजूद नहीं है
• 500 Internal Server Error — डेटाबेस या सेवा त्रुटि के कारण अनुवाद को अद्यतन नहीं किया जा सका