Fordítások javítása

Cseréld le manuálisan egy meglévő fordítás tárolt tartalmát. Akkor használd, amikor a gépi generálta eredményt ki kell javítani anélkül, hogy az egész dokumentumot újra kellene fordítani.

Végpont: PATCH /translations Hitelesítés: Bearer JWT (WorkOS)

Kérelem törzse

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

A document_id és a language kombinációja azonosítja a fordítás sorát.

Válasz

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

Source-hash viselkedése

Egy fordítás kézi frissítése nem változtatja meg a source_hash értékét.

Ennek eredményeként:

• ha a forrásdokumentum nem változott, egy későbbi POST /translation kihagyja a fordítást, és megőrzi a kézi javítást
• ha a forrásdokumentum megváltozik, a hash már nem egyezik, és egy későbbi fordítási feladat újragenerálhatja és felülírhatja a manuálisan javított tartalmat

Példa

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

Hibák

• 400 Bad Request — a content nem JSON objektum
• 401 Unauthorized — a bearer token hiányzik vagy érvénytelen
• 404 Not Found — nem létezik fordítás a megadott document_id és language értékekhez
• 500 Internal Server Error — a fordítást nem sikerült frissíteni adatbázis- vagy szolgáltatáshiba miatt