Empezando
Unova ofrece una plataforma completa de privacidad y conformidad: DSARs (acceso, rectificación, eliminación), consentimientos, preferencias de cookies, transparencia, auditoría e informes, con API REST, SDK, webhooks HMAC, KMS/BYOK y cifrado de punta a punta.
-
Paso 1
Crea tu cuenta
Equipo jurídico, de tecnología, seguridad cibernética y atención/soporte.
-
Paso 2
Configura políticas
Mapea sistemas, finalidades, bases legales y retención de tus datos.
-
Paso 3
Integra
Usa SDK/REST, habilita DSARs y publica/responde en el portal del titular.
Entornos y Endpoints
URL base
Estado
Autenticación
Bearer / JWT
Envía Authorization: Bearer <TOKEN> en todas las solicitudes.
Correlación
Usa X-Request-Id (UUID) para vincular solicitud↔respuesta y logs.
Idempotencia
Reenvíos seguros con X-Idempotency-Key.
Endpoints REST
/v1/dsars
type=access
Solicitud:
{não disponível}Respuesta (200):
{não disponível}
Usa receipt.signature como comprobante de auditoría.
/v1/dsars
type=rectification
{não disponível}
Opcional: incluye changes con campos y valores a rectificar.
/v1/dsars
type=erasure
{não disponível}
Soporta scope por sistemas/finalidades respetando reglas de retención.
/v1/dsars/{id}
/v1/consents
/v1/cookies/preferences
Define preferencias por categoría (ej.: necesarios, estadística, marketing) con registro de prueba.
{não disponível}/v1/cookies/preferences/{subjectId}
Webhooks HMAC
Valida la firma mediante X-Unova-Signature usando el raw body de la solicitud.
dsar.updated, consent.changed, cookies.preference.changed, policy.updated…
{não disponível}Criptografía y KMS
En tránsito y en reposo
TLS 1.2+ en tránsito y AES-256 en reposo (Cloud KMS). Logs de uso y rotación de claves.
KMS / BYOK
Trae tus propias llaves (BYOK) y controla ciclos de rotación y acceso.
Field-level encryption
Cifrado por campo vía SDK (WebCrypto/Libsodium). Las claves nunca salen de tu dominio.
SDK y ejemplos
Instala el SDK oficial y empieza en minutos.
Instalación
{não disponível}Crear DSAR con el SDK
{não disponível}Errores y límites
Formato de errores
{
"error": { "code": "invalid_request", "message": "Missing subjectId", "requestId": "7b5f6e5d-21d0..." }
}
Siempre devolvemos requestId en el error.
Rate limits
- 429 cuando se excede el límite.
-
Usa
Retry-Afterpara backoff exponencial. -
Se recomienda idempotencia con
X-Idempotency-Key.
Changelog
-
Webhook
policy.updated -
Soporte de
X-Idempotency-Keyen todos los POST - Mejoras de auditoría en el receipt
-
Endpoint
/v1/consentscon registro de prueba -
Campos de alcance en DSARs (
scope[])
- Habilitado HMAC SHA-256 en webhooks
- Sandbox público para pruebas
FAQ rápido
¿Qué lenguajes son soportados?
SDKs en JS/TS, Python, PHP y Go. REST disponible para cualquier lenguaje.
¿Cómo obtengo mi token?
En Configuraciones → API en el panel de Unova (se requieren roles adecuados).
¿Hay entorno de sandbox?
Sí. Usa https://api.sandbox.unova.digital para pruebas.
¿Blockchain/recibo legal?
Eventos críticos pueden generar recibo firmado y hash anclado para garantía legal.
