Documentation API

Intégrez CONSENTRYdans vos applications

API REST simple et sécurisée pour protéger les images, vérifier les consentements et générer des preuves légales.

Obtenir une clé API Exemples sur GitHub

Démarrage rapide

Trois étapes pour intégrer CONSENTRY dans votre application.

Obtenez votre clé

Créez un compte et générez une clé API depuis votre tableau de bord.

Protégez vos images

Envoyez vos images à l'API pour créer des manifestes de consentement signés.

Vérifiez et surveillez

Interrogez l'API pour vérifier les consentements et détecter les violations.

Exemple d'intégration

Protéger une image

const response = await fetch('https://api.consentry.io/v1/protect', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    image: base64Image,
    policy: {
      ai_training: false,
      ai_generation: false,
      sexual_content: false,
      commercial_use: true,
      derivatives: false
    }
  })
});

const manifest = await response.json();
// { asset_id: "asset_xxx", fingerprints: {...}, signature: "..." }

Vérifier une image

const response = await fetch('https://api.consentry.io/v1/verify', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    image: suspectImage,
    usage_type: 'ai_training'
  })
});

const result = await response.json();
// { allowed: false, manifest: {...}, similarity: 0.98 }

Endpoints principaux

L'API REST CONSENTRY expose les endpoints suivants.

Méthode	Endpoint	Description
POST	/v1/protect	Protéger une image et créer un manifeste
PATCH	/v1/protect/:id/policy	Modifier la politique de consentement
POST	/v1/protect/:id/revoke	Révoquer un consentement
POST	/v1/verify	Vérifier le consentement d'une image
GET	/v1/verify/:id	Récupérer les informations d'un manifeste
POST	/v1/report/violation	Générer un rapport de violation

Sécurité et authentification

Authentification Bearer

Toutes les requêtes doivent inclure votre clé API dans l'en-tête Authorization: Bearer YOUR_API_KEY.

HTTPS obligatoire

L'API n'accepte que les connexions HTTPS. Les requêtes HTTP sont automatiquement rejetées.

Signatures Ed25519

Tous les manifestes et rapports sont signés cryptographiquement pour garantir leur authenticité.

Horodatage RFC 3161

Chaque manifeste est horodaté par une autorité de certification reconnue (DigiCert).

Protection des clés API

Ne partagez jamais vos clés API. Ne les incluez pas dans du code côté client (JavaScript navigateur). Utilisez toujours un backend pour appeler l'API.

Structure de la politique

Définissez précisément les usages autorisés pour chaque image.

ConsentPolicy

{
  "ai_training": false,      // Entraînement de modèles IA
  "ai_generation": false,    // Génération d'images par IA
  "sexual_content": false,   // Contenu à caractère sexuel
  "commercial_use": true,    // Usage commercial
  "derivatives": false,      // Création de dérivés
  "expires_at": "2030-01-01" // Date d'expiration (optionnel)
}

ai_training: false

Interdit l'utilisation pour entraîner des modèles IA

ai_generation: false

Interdit la génération d'images basées sur l'original

sexual_content: false

Interdit tout usage à caractère sexuel ou pornographique

derivatives: false

Interdit la création de deepfakes ou d'œuvres dérivées

Limites et quotas

Plan	Requêtes/mois	Rate limit	Support
Gratuit	100	10 req/min	Email
Créateur	10 000	100 req/min	Email prioritaire
Pro	100 000	1000 req/min	Support dédié

Voir les tarifs détaillés

Prêt à intégrer CONSENTRY ?

Créez votre compte gratuitement et obtenez votre clé API en quelques secondes.

Obtenir une clé API Créer un compte