PATCH /translations

Rankiniu būdu pakeiskite esamo vertimo įrašytą turinį. Naudokite šią funkciją, kai reikia pataisyti mašininio vertimo rezultatą neperverčiant viso dokumento.

Pabaigos taškas: PATCH /translations Autentifikacija: Bearer JWT (WorkOS)

Užklausos turinys

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

Derinys document_id ir language identifikuoja vertimo įrašą.

Atsakymas

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

Source-hash elgsena

Rankiniu būdu atnaujinus vertimą, jo source_hash nepasikeičia.

Todėl:

• jei šaltinio dokumentas nepasikeitė, vėlesnis POST /translation praleidžia vertimą ir išsaugo rankinę pataisą
• jei šaltinio dokumentas pasikeičia, jo maišos reikšmė nebesutampa, ir vėlesnė vertimo užduotis gali iš naujo sugeneruoti bei perrašyti rankiniu būdu pataisytą turinį

Pavyzdys

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": "Ištaisytas turinys."
    }
  }'

Klaidos

• 400 Bad Request — content nėra JSON objektas
• 401 Unauthorized — prieigos raktas ("bearer" tokenas) trūksta arba jis neteisingas
• 404 Not Found — vertimas su pateiktu document_id ir language nerastas
• 500 Internal Server Error — vertimo nepavyko atnaujinti dėl duomenų bazės arba paslaugos klaidos