PATCH /translations

Sostituisci manualmente il contenuto salvato di una traduzione esistente. Usalo quando l'output generato automaticamente deve essere corretto senza ritradurre l'intero documento.

Endpoint: PATCH /translations Autenticazione: Bearer JWT (WorkOS)

Corpo della richiesta

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

La combinazione di document_id e language identifica la riga della traduzione.

Risposta

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

Comportamento di source_hash

L'aggiornamento manuale di una traduzione non modifica il suo source_hash.

Di conseguenza:

• se il documento sorgente non è cambiato, un successivo POST /translation salta la traduzione e conserva la correzione manuale
• se il documento sorgente cambia, il suo hash non corrisponde più e un successivo processo di traduzione può rigenerare e sovrascrivere il contenuto corretto manualmente

Esempio

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": "Contenuto corretto."
    }
  }'

Errori

• 400 Bad Request — content non è un oggetto JSON
• 401 Unauthorized — il token bearer è mancante o non valido
• 404 Not Found — non esiste alcuna traduzione per il document_id e la language forniti
• 500 Internal Server Error — non è stato possibile aggiornare la traduzione a causa di un errore del database o del servizio