Começando
A Unova oferece uma plataforma completa de privacidade e conformidade: DSARs (acesso, retificação, exclusão), consentimentos, preferências de cookies, transparência, auditoria e relatórios - com API REST, SDK, webhooks HMAC, KMS/BYOK e criptografia ponta a ponta.
-
Passo 1
Crie sua conta
Equipe de jurídico, tecnologia, segurança cibernética e atendimento/suporte.
-
Passo 2
Configure políticas
Mapeie sistemas, finalidades, bases legais e retenção de seus dados.
-
Passo 3
Integre
Use SDK/REST, habilite DSARs e publique/responda para o portal do titular.
Ambientes & Endpoints
Base URL
Status
Autenticação
Bearer / JWT
Envie Authorization: Bearer <TOKEN> em todas as requisições.
Correlação
Use X-Request-Id (UUID) para vincular solicitação↔resposta e logs.
Idempotência
Reenvios seguros com X-Idempotency-Key.
Endpoints REST
/v1/dsars
type=access
Requisição:
{não disponível}
Resposta (200):
{não disponível}
Use receipt.signature como comprovação de auditoria.
/v1/dsars
type=rectification
{não disponível}
Opcional: inclua changes com campos e valores a retificar.
/v1/dsars
type=erasure
{não disponível}
Suporta scope por sistemas/finalidades respeitando regras de retenção.
/v1/dsars/{id}
/v1/consents
/v1/cookies/preferences
Define preferências por categoria (ex.: necessários, estatística, marketing) com registro de prova.
{não disponível}
/v1/cookies/preferences/{subjectId}
Webhooks HMAC
Valide a assinatura via X-Unova-Signature usando o raw body do request.
dsar.updated, consent.changed, cookies.preference.changed, policy.updated…
{não disponível}
Criptografia & KMS
Em trânsito & repouso
TLS 1.2+ em trânsito e AES-256 em repouso (Cloud KMS). Logs de uso e rotação de chaves.
KMS / BYOK
Traga suas próprias chaves (BYOK) e controle ciclos de rotação e acesso.
Field-level encryption
Criptografia por campo via SDK (WebCrypto/Libsodium). Chaves nunca saem do seu domínio.
SDK & Exemplos
Instale o SDK oficial e comece em minutos.
Instalação
{não disponível}
Criar DSAR com SDK
{não disponível}
Erros & Limites
Padrão de erros
{
"error": { "code": "invalid_request", "message": "Missing subjectId", "requestId": "7b5f6e5d-21d0..." }
}
Sempre retornamos requestId no erro.
Rate limits
- 429 quando o limite for excedido.
-
Use
Retry-Afterpara backoff exponencial. -
Idempotência recomendada com
X-Idempotency-Key.
Changelog
-
Webhook
policy.updated -
Suporte a
X-Idempotency-Keyem todos os POSTs - Melhorias de auditoria no receipt
-
Endpoint
/v1/consentscom registro de prova -
Campos de escopo em DSARs (
scope[])
- Habilitado HMAC SHA-256 em webhooks
- Sandbox público para testes
FAQ rápido
Quais linguagens são suportadas?
SDKs em JS/TS, Python, PHP e Go. REST disponível para qualquer linguagem.
Como obtenho meu token?
Em Configurações → API no painel Unova (roles adequados são necessários).
Há ambiente de sandbox?
Sim. Use https://api.sandbox.unova.digital para testes.
Blockchain/recibo legal?
Eventos críticos podem gerar recibo assinado e hash ancorado para garantia legal.