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 — токенът за достъп липсва или е невалиден
• 404 Not Found — не съществува превод за предоставените document_id и language
• 500 Internal Server Error — преводът не може да бъде актуализиран поради грешка в базата данни или услугата