PATCH /translations

既存の単一の翻訳に保存されているコンテンツを手動で置き換えます。

既存の翻訳に保存されているコンテンツを手動で置き換えます。機械生成された出力を文書全体を再翻訳せずに修正する必要がある場合に使用します。

エンドポイント: PATCH /translations 認証: Bearer JWT（WorkOS）

リクエストボディ

{
  "document_id": "<uuid>",
  "language": "fr",
  "content": {
    "title": "Bonjour",
    "body": "..."
  }
}

フィールド	型	必須	備考
`document_id`	uuid	はい	翻訳に関連付けられたソースドキュメント。
`language`	string	はい	更新する翻訳の言語コード。
`content`	object	はい	置き換える翻訳済みコンテンツ。JSON オブジェクトである必要があります。

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": "修正されたコンテンツ。"
    }
  }'

エラー

400 Bad Request — content が JSON オブジェクトではありません
401 Unauthorized — ベアラートークンが不足しているか、無効です
404 Not Found — 指定された document_id と language に対応する翻訳が存在しません
500 Internal Server Error — データベースまたはサービスエラーにより翻訳を更新できませんでした

Previous‹POST /translation NextGET /usage›