Intégrez Anonimatum à vos systèmes

Démarrage rapide

Trois étapes : créer la clé API, la vérifier et anonymiser votre premier document.

1. Créez une clé API dans l'App : Profil → Clés API → « Générer une clé API ». Copiez-la immédiatement : elle ne sera plus affichée. Si la section n'apparaît pas, votre offre n'inclut pas l'accès à l'API ou c'est l'administrateur de votre groupe qui le gère.
2. Enregistrez-la comme variable d'environnement et vérifiez l'offre de votre groupe avec GET /api/public/plan.
3. Envoyez le document à POST /api/public/ai/anonymize avec les options d'IA dont vous avez besoin. La réponse est le document anonymisé dans son format d'origine.

export ANONIMATUM_API_KEY="tu_api_key"

# 1. Comprueba la clave: plan y cupo del grupo
curl -H "X-API-Key: $ANONIMATUM_API_KEY" \
  https://api.anonimatum.com/api/public/plan

# 2. Opciones de IA disponibles (rgpd, fechas, direcciones, qr…)
curl -H "X-API-Key: $ANONIMATUM_API_KEY" \
  https://api.anonimatum.com/api/public/ai/options

# 3. Primer anonimizado: PDF, Word, Excel o PowerPoint
curl -X POST https://api.anonimatum.com/api/public/ai/anonymize \
  -H "X-API-Key: $ANONIMATUM_API_KEY" \
  -F "file=@resolucion.pdf" \
  -F "aiOptions=rgpd,direcciones,qr" \
  -F "backgroundColor=black" \
  -F "textContent=none" \
  --output resolucion-anonimizada.pdf

Les paramètres des endpoints multipart sont envoyés comme champs de formulaire (-F). La consommation est décomptée de l'offre du groupe de la clé.

Authentification

X-API-Key

En-tête pour les intégrations de machine à machine. Chaque clé appartient à un utilisateur et à un groupe : elle utilise leurs permissions, leur offre et leur quota.

Authorization: Bearer

JWT de session utilisateur, le même que celui de l'App. Utile si vous intégrez Anonimatum dans une application avec connexion Politeia.

Isolation

Une ressource d'un autre groupe renvoie 404, jamais 403 : l'API ne révèle pas si elle existe.

Révocation

Révoquez une clé dans Profil → Clés API ; elle cesse de fonctionner immédiatement. Ne versionnez jamais de clés dans le code ou dans des dépôts.

Limites

Limites techniques de la version 1.9.0 (par adresse IP ou par requête) :

Chaque opération décompte également des pages ou des documents de l'offre du groupe. Consultez la consommation avec GET /api/public/usage/current et /usage/remaining, ou validez au préalable avec POST /usage/validate-operation.

Erreurs

Les erreurs suivent le format standard { errorCode, message, status }. Les plus fréquentes :

HTTP/1.1 403
Content-Type: application/json

{
  "errorCode": "PLAN_EXPIRED",
  "message": "Tu plan ha expirado. Contacta con el equipo de Politeia para renovarlo o activar un plan.",
  "status": 403
}

Basez votre logique sur errorCode, pas sur le texte du message, qui peut changer ou être traduit.

Webhooks

Un webhook notifie votre système par un POST JSON signé lorsqu'un lot de la file d'attente ou une publication se termine. La notification ne contient jamais de noms de fichiers, de titres, de texte ni d'adresses e-mail : uniquement des identifiants, des statuts et, pour les lots, un lien de téléchargement à utiliser avec votre clé API.

Événements

Enregistrement avec votre clé API

POST /api/public/webhooks renvoie le secret (whsec_…) une seule fois ; enregistrez-le comme variable d'environnement. Un webhook créé avec une clé API ne reçoit que les événements de l'utilisateur de cette clé ; l'administrateur du groupe peut créer des webhooks pour tout le groupe depuis le panneau de l'App. Également disponibles : GET, PUT et DELETE /{id}, POST /{id}/rotate-secret, POST /{id}/test et GET /{id}/deliveries. Jusqu'à 10 par groupe ; l'URL doit être en https.

curl -X POST https://api.anonimatum.com/api/public/webhooks \
  -H "X-API-Key: $ANONIMATUM_API_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://erp.ejemplo.es/anonimatum/webhook","events":["batch.completed","batch.failed"]}'

Vérifier la signature

Chaque notification porte l'en-tête X-Anonimatum-Signature: t=<unix>,v1=<hex>, où v1 est un HMAC-SHA256 calculé avec le secret complet (préfixe whsec_ inclus) sur « t.body ». Les en-têtes X-Anonimatum-Event, X-Anonimatum-Event-Id et X-Anonimatum-Delivery sont également envoyés.

1. Lisez le corps brut, sans analyser ni reformater le JSON.
2. Séparez t et v1 de l'en-tête et rejetez la notification si t s'écarte de plus de 300 secondes de votre horloge.
3. Calculez HMAC-SHA256(secret, t + "." + body) en hexadécimal et comparez-le à v1 en temps constant.
4. Dédupliquez par X-Anonimatum-Event-Id : une nouvelle tentative porte le même identifiant.
5. Répondez 2xx en moins de 5 secondes et traitez ensuite.

Node.js (Express)

import crypto from "node:crypto";
import express from "express";

const app = express();
const SECRET = process.env.ANONIMATUM_WEBHOOK_SECRET; // whsec_… completo

app.post("/anonimatum/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const parts = Object.fromEntries(
    (req.get("X-Anonimatum-Signature") ?? "").split(",").map((p) => p.split("=", 2))
  );
  const t = Number(parts.t);
  if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > 300) return res.sendStatus(400);
  const expected = crypto.createHmac("sha256", SECRET).update(t + ".").update(req.body).digest("hex");
  const given = Buffer.from(parts.v1 ?? "", "utf8");
  const ok = given.length === expected.length && crypto.timingSafeEqual(Buffer.from(expected, "utf8"), given);
  if (!ok) return res.sendStatus(401);
  // Deduplica por req.get("X-Anonimatum-Event-Id") y procesa después.
  res.sendStatus(204);
});

Python (Flask)

import hashlib, hmac, os, time
from flask import Flask, abort, request

app = Flask(__name__)
SECRET = os.environ["ANONIMATUM_WEBHOOK_SECRET"].encode()  # whsec_… completo

@app.post("/anonimatum/webhook")
def webhook():
    body = request.get_data()  # cuerpo crudo, sin parsear
    header = request.headers.get("X-Anonimatum-Signature", "")
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    try:
        t = int(parts["t"])
    except (KeyError, ValueError):
        abort(400)
    if abs(time.time() - t) > 300:
        abort(400)
    expected = hmac.new(SECRET, f"{t}.".encode() + body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, parts.get("v1", "")):
        abort(401)
    # Deduplica por request.headers["X-Anonimatum-Event-Id"] y procesa después.
    return "", 204

Toute réponse autre que 2xx (les redirections ne sont pas suivies) ou plus lente que 5 secondes est considérée comme un échec. Après la première tentative, les nouvelles tentatives ont lieu à 1 min, 5 min, 30 min, 2 h et 6 h (6 tentatives au total) ; le journal des livraisons indique le statut, le code HTTP et la prochaine tentative.

Si vous préférez ne pas exposer d'endpoint, interrogez l'état des lots avec GET /api/public/batch-jobs et téléchargez les tâches terminées avec GET /api/public/batch-jobs/{id}/output.

Connecteur MCP pour assistants IA

Anonimatum expose la même API sous forme de serveur MCP (Model Context Protocol). L'assistant agit en tant que votre utilisateur et votre groupe après que vous l'avez autorisé dans l'App.

URL du serveur MCP

https://gateway.politeiasoft.com/anonimatum/mcp

Claude

Dans claude.ai → Paramètres → Connecteurs, ajoutez un connecteur personnalisé avec l'URL MCP et autorisez l'accès sur l'écran de consentement d'Anonimatum.

ChatGPT

Dans chatgpt.com → Paramètres → Connecteurs, ajoutez l'URL MCP et finalisez l'autorisation OAuth. La disponibilité des connecteurs personnalisés dépend de votre offre ChatGPT.

Grok

Dans grok.com → Connecteurs, ajoutez l'URL MCP et autorisez l'accès.

Cursor, Claude Code et autres clients MCP

Si le client prend en charge OAuth avec redirection locale, l'URL suffit. Sinon, utilisez l'autorisation manuelle dans l'App (Profil → Connecteurs) : vous obtenez un jeton et un mcp.json prêt à coller.

Outils exposés

• listar_operaciones — Liste les opérations disponibles pour votre utilisateur (même catalogue que la référence, sans endpoints d'administration ni internes).
• describir_operacion — Méthode, chemin, paramètres et mode d'envoi des fichiers pour une opération.
• ejecutar_operacion — Exécute une opération ; les réponses binaires incluent un lien de téléchargement à usage unique.
• iniciar_subida_fichero — Renvoie une URL d'envoi à usage unique, recommandée pour les documents volumineux (jusqu'à 250 MB).
• subir_fichero — Envoie un petit fichier en Base64 en un seul appel.
• iniciar_subida_por_partes / subir_parte_fichero — Envoi par morceaux pour les clients qui ne peuvent pas faire de POST direct.

Les opérations irréversibles (suppression, désanonymisation) exigent la confirmation explicite de l'utilisateur dans ce même tour. Avec une offre expirée, l'assistant reçoit PLAN_EXPIRED et doit transmettre le message sans réessayer. Vous pouvez révoquer chaque connexion dans Profil → Connecteurs.

Exemple de mcp.json (autorisation manuelle)

{
  "mcpServers": {
    "anonimatum": {
      "url": "https://gateway.politeiasoft.com/anonimatum/mcp",
      "headers": { "Authorization": "Bearer <token de la concesión manual>" }
    }
  }
}

SDK

Accès sur demande

SDK officiels pour Python (synchrone et asyncio) et TypeScript/JavaScript (Node 18+), construits sur cette même référence. Le dépôt est privé : demandez l'accès à Politeia via le formulaire de contact. Vous pouvez aussi générer un client à partir du fichier OpenAPI.

Dépôt du SDK (privé)