PATCH /translations

Asenda olemasoleva tõlke salvestatud sisu käsitsi. Kasuta seda siis, kui masinaga loodud väljundit tuleb parandada ilma kogu dokumenti uuesti tõlkimata.

Lõpppunkt: PATCH /translations Autentimine: Bearer JWT (WorkOS)

Päringu keha

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

Kombinatsioon document_id ja language väljadest tuvastab tõlkerea.

Vastus

{
  "document_id": "<uuid>",
  "language": "fr",
  "updated": true
}

Allika räsi käitumine

Tõlke käsitsi uuendamine ei muuda selle source_hash väärtust.

Seetõttu:

• kui algdokument pole muutunud, jätab hilisem POST /translation tõlke vahele ja säilitab käsitsi paranduse
• kui algdokument muutub, ei lange selle räsi enam kokku ning hilisem tõlketöö võib sisu uuesti luua ja käsitsi parandatud sisu üle kirjutada

Näide

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": "Tere",
      "body": "Parandatud sisu."
    }
  }'

Veateated

• 400 Bad Request — content ei ole JSON-objekt
• 401 Unauthorized — Bearer-märgis puudub või on vigane
• 404 Not Found — antud document_id ja language jaoks tõlget ei leidu
• 500 Internal Server Error — tõlget ei saanud uuendada andmebaasi- või teenuse vea tõttu