Proteção de dados com o CodeVeil

Este guia mostra como proteger dados sensíveis com o CodeVeil: mascarando PII, usando ofuscação que preserva o formato para que os seus dados de teste continuem realistas, executando grandes trabalhos em lote de até 10.000 registros e sendo notificado via webhooks quando eles terminam.

Mascarando campos sensíveis

O CodeVeil mascara PII, dados financeiros e registros de saúde ao mesmo tempo que preserva o formato e a integridade referencial — o mesmo cliente é mapeado para o mesmo valor mascarado em todos os lugares em que aparece. Envie os registros ao endpoint de mascaramento e descreva quais campos proteger:

curl -X POST https://api.keepflow.ai/v1/codeveil/mask \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      { "name": "Jane Doe", "email": "[email protected]", "iban": "DE89370400440532013000" }
    ],
    "fields": {
      "name": "name",
      "email": "email",
      "iban": "iban"
    }
  }'

Ofuscação que preserva o formato

A chave para dados de teste úteis é que eles precisam ter a aparência e o comportamento dos dados reais. A saída ofuscada do CodeVeil mantém a mesma estrutura, os mesmos tipos e as mesmas relações do original: um e-mail continua parecendo um e-mail válido, um IBAN mantém o seu código de país e o formato do dígito verificador, um número de telefone mantém o seu padrão.

{
  "name": "Marta Lindqvist",
  "email": "[email protected]",
  "iban": "DE21500105174829471138"
}

Como o formato é preservado, você pode colocar o conjunto de dados mascarado direto em um ambiente de staging ou de teste, e toda validação, junção e relação de chave estrangeira continua funcionando.

Processamento em lote

Para grandes conjuntos de dados, envie até 10.000 registros em uma única requisição ao endpoint de lote. O trabalho é executado de forma assíncrona, então você não precisa manter uma conexão aberta:

curl -X POST https://api.keepflow.ai/v1/codeveil/batch \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-app.com/hooks/codeveil",
    "records": [ /* up to 10,000 records */ ],
    "fields": { "email": "email", "ssn": "national_id" }
  }'

A resposta retorna um ID de trabalho que você pode usar para consultar o status, ou você pode aguardar o webhook.

{
  "data": { "job_id": "job_9f2a", "status": "processing", "record_count": 10000 }
}

Webhooks de conclusão

Em vez de fazer consultas, registre um callback_url e o CodeVeil fará um POST para ele quando o trabalho terminar. O payload usa o evento data.processed:

{
  "event": "data.processed",
  "timestamp": "2026-07-17T09:12:00Z",
  "data": {
    "job_id": "job_9f2a",
    "status": "completed",
    "record_count": 10000,
    "download_url": "https://api.keepflow.ai/v1/codeveil/results/job_9f2a"
  }
}

Verifique o cabeçalho X-KeepFlow-Signature com o seu segredo de webhook antes de confiar no payload e, em seguida, busque o conjunto de dados mascarado a partir do download_url. Os resultados ficam disponíveis por 24 horas após a conclusão.