PATCH /translations

Αντικαταστήστε χειροκίνητα το αποθηκευμένο περιεχόμενο μιας υπάρχουσας μετάφρασης. Χρησιμοποιήστε το όταν η έξοδος που παράγεται από μηχανή χρειάζεται διόρθωση χωρίς να μεταφραστεί ξανά ολόκληρο το έγγραφο.

Σημείο τερματισμού: PATCH /translations Έλεγχος ταυτότητας: Bearer JWT (WorkOS)

Σώμα αιτήματος

{
  "document_id": "<uuid>",
  "language": "fr",
  "content": {
    "title": "Καλημέρα",
    "body": "..."
  }
}

Ο συνδυασμός των document_id και language ταυτοποιεί τη γραμμή μετάφρασης.

Απάντηση

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

Συμπεριφορά του source-hash

Η χειροκίνητη ενημέρωση μιας μετάφρασης δεν αλλάζει το source_hash της.

Ως αποτέλεσμα:

• εάν το έγγραφο προέλευσης δεν έχει αλλάξει, ένα μεταγενέστερο POST /translation παραλείπει τη μετάφραση και διατηρεί τη χειροκίνητη διόρθωση
• εάν το έγγραφο προέλευσης αλλάξει, το hash του δεν ταιριάζει πλέον και ένα μεταγενέστερο έργο μετάφρασης μπορεί να αναδημιουργήσει και να αντικαταστήσει το περιεχόμενο που διορθώθηκε χειροκίνητα

Παράδειγμα

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": "Καλημέρα",
      "body": "Διορθωμένο περιεχόμενο."
    }
  }'

Σφάλματα

• 400 Bad Request — το content δεν είναι αντικείμενο JSON
• 401 Unauthorized — λείπει ή δεν είναι έγκυρο το διακριτικό φορέα
• 404 Not Found — δεν υπάρχει μετάφραση για τα παρεχόμενα document_id και language
• 500 Internal Server Error — η μετάφραση δεν ήταν δυνατό να ενημερωθεί λόγω σφάλματος βάσης δεδομένων ή υπηρεσίας