PATCH /translations

Ročno zamenjajte shranjeno vsebino obstoječega prevoda. Uporabite to, ko je treba strojno ustvarjeni rezultat popraviti brez ponovnega prevoda celotnega dokumenta.

Končna točka: PATCH /translations Avtentikacija: Bearer JWT (WorkOS)

Telo zahtevka

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

Kombinacija document_id in language določa vrstico prevoda.

Odziv

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

Obnašanje source_hash

Ročna posodobitev prevoda ne spremeni njegove vrednosti source_hash.

Posledično:

• če se izvorni dokument ni spremenil, poznejši POST /translation preskoči prevod in ohrani ročni popravek
• če se izvorni dokument spremeni, njegov hash več ne ustreza in poznejša opravila prevajanja lahko znova ustvarijo ter prepišejo ročno popravljeno vsebino

Primer

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": "Pozdravljeni",
      "body": "Popravljena vsebina."
    }
  }'

Napake

• 400 Bad Request — content ni objekt JSON
• 401 Unauthorized — žeton posrednika (bearer) manjka ali je neveljaven
• 404 Not Found — za podani document_id in language ne obstaja noben prevod
• 500 Internal Server Error — prevoda ni bilo mogoče posodobiti zaradi napake baze podatkov ali storitve