PATCH /translations

استبدل يدويًا المحتوى المخزَّن لترجمة موجودة. استخدم هذا الإجراء عندما يحتاج الإخراج المُولَّد آليًا إلى تصحيح من دون إعادة ترجمة المستند بأكمله.

نقطة النهاية: PATCH /translations المصادقة: رمز JWT من نوع Bearer ‏(WorkOS)

جسم الطلب

{
  "document_id": "<uuid>",
  "language": "fr",
  "content": {
    "title": "مرحبًا",
    "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": "مرحبًا",
      "body": "محتوى مصحَّح."
    }
  }'

الأخطاء

• 400 طلب غير صالح — الحقل content ليس كائن JSON
• 401 غير مصرح — رمز Bearer مفقود أو غير صالح
• 404 غير موجود — لا توجد ترجمة للقيمتين document_id وlanguage المُقدَّمتين
• 500 خطأ خادم داخلي — تعذَّر تحديث الترجمة بسبب خطأ في قاعدة البيانات أو الخدمة