PATCH /translations

החלף באופן ידני את התוכן השמור של תרגום קיים. השתמש בכך כאשר יש צורך לתקן פלט שנוצר במכונה מבלי לתרגם מחדש את כל המסמך.

נקודת קצה: 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

עדכון ידני של תרגום אינו משנה את source_hash שלו.

כתוצאה מכך:

• אם מסמך המקור לא השתנה, קריאה מאוחרת יותר אל POST /translation מדלגת על התרגום ושומרת על התיקון הידני
• אם מסמך המקור משתנה, ה-hash שלו כבר לא תואם ומשימת תרגום מאוחרת יותר עשויה ליצור מחדש ולדרוס את התוכן שתוקן ידנית

דוגמה

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 — אסימון ה-bearer חסר או שגוי
• 404 Not Found — לא קיים תרגום עבור ה-document_id וה-language שסופקו
• 500 Internal Server Error — לא ניתן היה לעדכן את התרגום בשל שגיאת מסד נתונים או שירות