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 пропускает перевод и сохраняет ручную правку
• если исходный документ изменится, его хеш перестанет совпадать, и последующее задание перевода может заново сгенерировать и перезаписать вручную исправленное содержимое

Пример

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 — перевод не удалось обновить из-за ошибки базы данных или сервиса