PATCH /translations

Vervang handmatig de opgeslagen inhoud van een bestaande vertaling. Gebruik dit wanneer machinegegenereerde output moet worden gecorrigeerd zonder het volledige document opnieuw te vertalen.

Eindpunt: PATCH /translations Authenticatie: Bearer JWT (WorkOS)

Aanvraagbody

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

De combinatie van document_id en language identificeert de vertaalregel.

Respons

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

Gedrag van de bronhash

Handmatig bijwerken van een vertaling verandert de source_hash niet.

Als gevolg daarvan:

• als het brondocument niet is gewijzigd, slaat een latere POST /translation de vertaling over en blijft de handmatige correctie behouden
• als het brondocument verandert, komt de hash niet langer overeen en kan een latere vertaaltaak de handmatig gecorrigeerde inhoud opnieuw genereren en overschrijven

Voorbeeld

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

Fouten

• 400 Bad Request — content is geen JSON-object
• 401 Unauthorized — bearer token ontbreekt of is ongeldig
• 404 Not Found — er bestaat geen vertaling voor de opgegeven document_id en language
• 500 Internal Server Error — de vertaling kon niet worden bijgewerkt wegens een database- of servicefout