Unova
Chargement...
Documentation

SDK, API REST et sécurité de bout en bout

Intégrez les DSAR (accès, rectification, suppression), consentements, préférences de cookies, transparence et audit avec SDK, REST et webhooks HMAC. KMS/BYOK, chiffrement au niveau du champ et corrélation sécurisée requête↔réponse.

API REST SDK Webhooks HMAC KMS / BYOK Chiffrement de bout en bout

Pour commencer

Unova offre une plateforme complète de confidentialité et de conformité : DSAR (accès, rectification, suppression), consentements, préférences de cookies, transparence, audit et rapports – avec API REST, SDK, webhooks HMAC, KMS/BYOK et chiffrement de bout en bout.

  1. Étape 1

    Créez votre compte

    Équipe juridique, technologie, sécurité et support/assistance.

  2. Étape 2

    Configurez vos politiques

    Cartographiez les systèmes, finalités, bases légales et rétention de vos données.

  3. Étape 3

    Intégrez

    Utilisez SDK/REST, activez les DSAR et publiez/répondez via le portail du titulaire.

Environnements & endpoints

Environnement :

URL de base

Statut

Authentification

Bearer / JWT

Envoyez Authorization: Bearer <TOKEN> dans toutes les requêtes.

Corrélation

Utilisez X-Request-Id (UUID) pour lier requête↔réponse et logs.

Idempotence

Réémissions sécurisées avec X-Idempotency-Key.

Endpoints REST

POST /v1/dsars type=access
Roles: admin, dpo, legal Scopes: dsar:write

Requête :

{não disponível}

Réponse (200) :

{não disponível}

Utilisez receipt.signature comme preuve d’audit.

POST /v1/dsars type=rectification
Roles: admin, dpo, legal Scopes: dsar:write
{não disponível}

Optionnel : incluez changes avec les champs et valeurs à rectifier.

POST /v1/dsars type=erasure
Roles: admin, dpo, legal Scopes: dsar:write
{não disponível}

Prend en charge scope par systèmes/finalités en respectant les règles de rétention.

GET /v1/dsars/{id}
Roles: admin, dpo, legal, suporte Scopes: dsar:read
Renvoie le statut mis à jour, l’historique et le reçu signé.
POST /v1/consents
Roles: admin, dpo, legal Scopes: consent:write
Enregistre/met à jour les consentements avec preuve et préférences par finalité.
POST /v1/cookies/preferences
Roles: admin, dpo, legal, web Scopes: cookie:write

Définit des préférences par catégorie (ex. : nécessaires, statistique, marketing) avec preuve.

{não disponível}
GET /v1/cookies/preferences/{subjectId}
Roles: admin, dpo, legal, web, suporte Scopes: cookie:read
Renvoie les préférences actuelles et l’empreinte de preuve.

Webhooks HMAC

Validez la signature via X-Unova-Signature en utilisant le raw body de la requête.

ÉVÉNEMENTS dsar.updated, consent.changed, cookies.preference.changed, policy.updated…
{não disponível}

Chiffrement & KMS

En transit & au repos

TLS 1.2+ en transit et AES-256 au repos (Cloud KMS). Journaux d’utilisation et rotation des clés.

KMS / BYOK

Apportez vos propres clés (BYOK) et contrôlez les cycles de rotation et d’accès.

Chiffrement au niveau du champ

Chiffrement par champ via SDK (WebCrypto/Libsodium). Les clés ne quittent jamais votre domaine.

SDK & exemples

Installez le SDK officiel et commencez en quelques minutes.

Installation

{não disponível}

Créer un DSAR avec le SDK

{não disponível}

Erreurs & limites

Format des erreurs

{
"error": { "code": "invalid_request", "message": "Missing subjectId", "requestId": "7b5f6e5d-21d0..." }
}

Nous renvoyons toujours requestId dans l’erreur.

Limites de taux

  • 429 lorsque la limite est dépassée.
  • Utilisez Retry-After pour un backoff exponentiel.
  • Idempotence recommandée avec X-Idempotency-Key.

Changelog

v1.12.0 2025-08-15
  • Webhook policy.updated
  • Prise en charge de X-Idempotency-Key dans tous les POST.
  • Améliorations d’audit dans le receipt
v1.11.0 2025-07-10
  • Endpoint /v1/consents avec preuve enregistrée
  • Champs de scope dans les DSAR (scope[])
v1.10.0 2025-06-03
  • HMAC SHA-256 activé sur les webhooks
  • Sandbox public pour tests

FAQ rapide

Quels langages sont supportés ?

SDK en JS/TS, Python, PHP et Go. REST disponible pour n’importe quel langage.

Comment obtenir mon jeton ?

Dans Paramètres → API sur le panneau Unova (rôles appropriés nécessaires).

Y a-t-il un environnement sandbox ?

Oui. Utilisez https://api.sandbox.unova.digital pour les tests.

Blockchain/reçu légal ?

Les événements critiques peuvent générer un reçu signé et un hash ancré pour une garantie légale.

Prenez le contrôle de vos données personnelles.

Gérez les consentements et préférences en toute transparence – en conformité avec la LGPD/RGPD.

Nous utilisons des cookies pour améliorer votre expérience

Certains sont essentiels et d’autres nous aident à comprendre comment vous utilisez le site.
Vous pouvez tout accepter, refuser les non essentiels ou personnaliser.
Lisez notre Politique de confidentialité.