Korekty tłumaczeń

Ręcznie zastąp przechowywaną zawartość istniejącego tłumaczenia. Użyj tego, gdy trzeba skorygować wynik wygenerowany przez maszynę bez ponownego tłumaczenia całego dokumentu.

Punkt końcowy: PATCH /translations Uwierzytelnianie: Bearer JWT (WorkOS)

Treść żądania

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

Kombinacja document_id i language identyfikuje wiersz tłumaczenia.

Odpowiedź

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

Zachowanie skrótu źródłowego

Ręczna aktualizacja tłumaczenia nie zmienia jego source_hash.

W konsekwencji:

• jeśli dokument źródłowy się nie zmienił, późniejszy POST /translation pomija tłumaczenie i zachowuje ręczną korektę
• jeśli dokument źródłowy ulegnie zmianie, jego skrót przestaje pasować i późniejsze zadanie tłumaczenia może zregenerować i nadpisać ręcznie poprawioną treść

Przykład

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

Błędy

• 400 Bad Request — content nie jest obiektem JSON
• 401 Unauthorized — token typu bearer jest nieobecny lub nieprawidłowy
• 404 Not Found — dla podanych wartości document_id i language nie istnieje żadne tłumaczenie
• 500 Internal Server Error — tłumaczenie nie mogło zostać zaktualizowane z powodu błędu bazy danych lub usługi