Patch-Übersetzungen

Ersetze den gespeicherten Inhalt einer bestehenden Übersetzung manuell. Verwende dies, wenn maschinell erzeugte Ausgaben korrigiert werden müssen, ohne das gesamte Dokument erneut zu übersetzen.

Endpunkt: PATCH /translations Authentifizierung: Bearer JWT (WorkOS)

Request-Body

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

Die Kombination aus document_id und language identifiziert die Übersetzungszeile.

Antwort

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

Verhalten des Source-Hash

Das manuelle Aktualisieren einer Übersetzung ändert ihren source_hash nicht.

Daraus folgt:

• Wenn sich das Quelldokument nicht geändert hat, überspringt ein späteres POST /translation die Übersetzung und behält die manuelle Korrektur bei.
• Wenn sich das Quelldokument ändert, stimmt sein Hash nicht mehr überein, und ein späterer Übersetzungsauftrag kann den Inhalt neu erstellen und die manuell korrigierte Fassung überschreiben.

Beispiel

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": "Korrigierter Inhalt."
    }
  }'

Fehler

• 400 Bad Request — content ist kein JSON-Objekt
• 401 Unauthorized — Das Bearer-Token fehlt oder ist ungültig
• 404 Not Found — Es existiert keine Übersetzung für den angegebenen document_id und language
• 500 Internal Server Error — Die Übersetzung konnte aufgrund eines Datenbank- oder Dienstfehlers nicht aktualisiert werden