PATCH /translations

Ručne nahraďte uložený obsah existujúceho prekladu. Použite to vtedy, keď je potrebné opraviť strojovo vygenerovaný výstup bez opätovného prekladu celého dokumentu.

Koncový bod: PATCH /translations Autorizácia: Bearer JWT (WorkOS)

Telo požiadavky

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

Kombinácia document_id a language identifikuje riadok prekladu.

Odpoveď

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

Správanie hash hodnoty zdroja

Ručná aktualizácia prekladu nemení jeho source_hash.

V dôsledku toho:

• ak sa zdrojový dokument nezmenil, neskorší POST /translation preklad preskočí a zachová ručnú opravu
• ak sa zdrojový dokument zmení, jeho hash už nebude zodpovedať a neskoršia prekladová úloha môže obsah znova vygenerovať a prepísať ručne opravený obsah

Príklad

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é."
    }
  }'

Chyby

• 400 Bad Request — content nie je objekt JSON
• 401 Unauthorized — chýba alebo je neplatný bearer token
• 404 Not Found — pre zadané document_id a language neexistuje preklad
• 500 Internal Server Error — preklad nebolo možné aktualizovať kvôli chybe databázy alebo služby