PATCH /translations

Substitua manualmente o conteúdo armazenado de uma tradução existente. Use isso quando a saída gerada por máquina precisar ser corrigida sem retraduzir todo o documento.

Endpoint: PATCH /translations Autenticação: Bearer JWT (WorkOS)

Corpo da solicitação

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

A combinação de document_id e language identifica a linha da tradução.

Resposta

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

Comportamento do hash de origem

Atualizar manualmente uma tradução não altera seu source_hash.

Como resultado:

• se o documento de origem não tiver mudado, um POST /translation posterior ignora a tradução e preserva a correção manual
• se o documento de origem mudar, seu hash deixa de corresponder e uma tarefa de tradução posterior pode regenerar e sobrescrever o conteúdo corrigido manualmente

Exemplo

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

Erros

• 400 Bad Request — content não é um objeto JSON
• 401 Unauthorized — o token bearer está ausente ou é inválido
• 404 Not Found — não existe tradução para o document_id e language fornecidos
• 500 Internal Server Error — a tradução não pôde ser atualizada devido a um erro de banco de dados ou de serviço