A começar
A Unova oferece uma plataforma completa de privacidade e conformidade: DSARs (acesso, retificação, eliminaçã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 a sua conta
Equipa de jurídico, tecnologia, segurança cibernética e atendimento/suporte.
-
Passo 2
Configure políticas
Mapeie sistemas, finalidades, bases legais e regras de retenção dos seus dados.
-
Passo 3
Integre
Use SDK/REST, ative DSARs e publique/responda no Portal do Titular.
Ambientes & Endpoints
Base URL
Estado
Autenticação
Bearer / JWT
Envie Authorization: Bearer <TOKEN> em todas as requisições.
Correlação
Use X-Request-Id (UUID) para associar pedido↔resposta e registos.
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 registo de prova.
{não disponível}/v1/cookies/preferences/{subjectId}
Webhooks HMAC
Valide a assinatura via X-Unova-Signature usando o raw body do pedido.
dsar.updated, consent.changed, cookies.preference.changed, policy.updated…
{não disponível}Criptografia & KMS
Em trânsito & em repouso
TLS 1.2+ em trânsito e AES-256 em repouso (Cloud KMS). Registos de uso e rotação de chaves.
KMS / BYOK
Traga as suas próprias chaves (BYOK) e controle ciclos de rotação e acesso.
Encriptação ao nível de campo
Criptografia por campo via SDK (WebCrypto/Libsodium). As 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..." }
}
Devolvemos sempre requestId no erro.
Limites de taxa
- 429 quando o limite for excedido.
-
Use
Retry-Afterpara aplicar 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 registo de prova -
Campos de escopo em DSARs (
scope[])
- Habilitado HMAC SHA-256 em webhooks
- Sandbox público para testes
FAQ rápido
Que linguagens são suportadas?
SDKs em JS/TS, Python, PHP e Go. REST disponível para qualquer linguagem.
Como obtenho o meu token?
Em Configurações → API no painel Unova (são necessários perfis adequados).
Existe 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.
