PATCH /translations

Ganti secara manual konten yang tersimpan dari terjemahan yang sudah ada. Gunakan ini ketika keluaran yang dihasilkan mesin perlu diperbaiki tanpa menerjemahkan ulang seluruh dokumen.

Titik Akhir: PATCH /translations Otorisasi: Bearer JWT (WorkOS)

Badan permintaan

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

Kombinasi document_id dan language mengidentifikasi baris terjemahan.

Respons

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

Perilaku source-hash

Memperbarui terjemahan secara manual tidak mengubah source_hash-nya.

Akibatnya:

• jika dokumen sumber belum berubah, POST /translation selanjutnya melewati terjemahan dan mempertahankan koreksi manual
• jika dokumen sumber berubah, hash-nya tidak lagi cocok dan pekerjaan terjemahan berikutnya dapat membuat ulang serta menimpa konten yang telah dikoreksi secara manual

Contoh

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

Kesalahan

• 400 Bad Request — content bukan objek JSON
• 401 Unauthorized — token bearer hilang atau tidak valid
• 404 Not Found — tidak ada terjemahan untuk document_id dan language yang diberikan
• 500 Internal Server Error — terjemahan tidak dapat diperbarui karena kesalahan basis data atau layanan