PATCH /translations

Korvaa olemassa olevan käännöksen tallennetun sisällön manuaalisesti. Käytä tätä, kun koneellisesti tuotettua tulosta täytyy korjata kääntämättä koko asiakirjaa uudelleen.

Päätepiste: PATCH /translations Tunnistautuminen: Bearer JWT (WorkOS)

Pyyntörunko

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

Yhdistelmä document_id- ja language-kentistä yksilöi käännösrivin.

Vastaus

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

Lähdehashin toiminta

Käännöksen manuaalinen päivittäminen ei muuta sen source_hash-arvoa.

Seurauksena:

• jos lähdeasiakirja ei ole muuttunut, myöhempi POST /translation ohittaa käännöksen ja säilyttää manuaalisen korjauksen
• jos lähdeasiakirja muuttuu, sen tiiviste ei enää täsmää ja myöhempi käännöstyö voi luoda sisällön uudelleen ja korvata manuaalisesti korjatun sisällön

Esimerkki

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": "Hei",
      "body": "Korjattu sisältö."
    }
  }'

Virheet

• 400 Bad Request — content ei ole JSON-objekti
• 401 Unauthorized — bearer-tunnus puuttuu tai on virheellinen
• 404 Not Found — annetuille document_id- ja language-arvoille ei ole olemassa käännöstä
• 500 Internal Server Error — käännöstä ei voitu päivittää tietokanta- tai palveluvirheen vuoksi