번역 패치

기존 번역에 저장된 콘텐츠를 수동으로 교체합니다. 문서 전체를 다시 번역하지 않고 기계 생성 결과를 수정해야 할 때 사용하세요.

엔드포인트: 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 — 데이터베이스 또는 서비스 오류로 번역을 업데이트하지 못했습니다