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.

ผลลัพธ์ที่ตามมา:

• หากเอกสารต้นทางไม่เปลี่ยนแปลง 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 — โทเค็นแบบ Bearer หายไปหรือไม่ถูกต้อง
• 404 Not Found — ไม่มีคำแปลสำหรับ document_id และ language ที่ระบุ
• 500 Internal Server Error — ไม่สามารถอัปเดตคำแปลได้เนื่องจากข้อผิดพลาดของฐานข้อมูลหรือบริการ