Оновлення перекладів

Вручну замініть збережений вміст наявного перекладу. Використовуйте це, коли машинний результат потрібно виправити без повторного перекладу всього документа.

Кінцева точка: 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 — токен носія відсутній або недійсний
• 404 Not Found — переклад для вказаних document_id і language не існує
• 500 Internal Server Error — переклад не вдалося оновити через помилку бази даних або сервісу