PATCH /translations

Thay thế thủ công nội dung đã lưu của một bản dịch hiện có. Sử dụng tính năng này khi đầu ra do máy tạo cần được chỉnh sửa mà không phải dịch lại toàn bộ tài liệu.

Điểm cuối: PATCH /translations Xác thực: Bearer JWT (WorkOS)

Thân yêu cầu

{
  "document_id": "<uuid>",
  "language": "fr",
  "content": {
    "title": "Xin chào",
    "body": "..."
  }
}

Sự kết hợp của document_id và language xác định hàng bản dịch.

Phản hồi

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

Hành vi của source-hash

Cập nhật bản dịch thủ công không làm thay đổi source_hash của nó.

Do đó:

• nếu tài liệu nguồn chưa thay đổi, một yêu cầu POST /translation về sau sẽ bỏ qua việc dịch và giữ nguyên phần chỉnh sửa thủ công
• nếu tài liệu nguồn thay đổi, giá trị băm của nó sẽ không còn khớp và một tác vụ dịch sau đó có thể tạo lại và ghi đè nội dung đã chỉnh sửa thủ công

Ví dụ

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": "Xin chào",
      "body": "Nội dung đã chỉnh sửa."
    }
  }'

Lỗi

• 400 Yêu cầu không hợp lệ — content không phải là một đối tượng JSON
• 401 Chưa được ủy quyền — mã thông báo bearer bị thiếu hoặc không hợp lệ
• 404 Không tìm thấy — không có bản dịch nào tồn tại cho document_id và language đã cung cấp
• 500 Lỗi máy chủ nội bộ — bản dịch không thể được cập nhật do lỗi cơ sở dữ liệu hoặc dịch vụ