Créez des intégrations sécurisées avec LeakData

Introduction

L’API LeakData.io vous permet d’ajouter des vérifications d’exposition aux fuites de données et une surveillance de sécurité à vos propres processus via une interface REST.

Fonctionnalités

• Rechercher des signaux d’exposition dans les données de fuites indexées
• Utiliser un point de terminaison de recherche unifié pour vérifier les adresses e-mail, les numéros de téléphone, les noms d’utilisateur et les domaines
• Créer des clés API depuis le tableau de bord
• Utiliser l’accès entreprise à l’API et aux webhooks pour des intégrations gérées
• Envoyer des charges utiles SIEM/SOAR signées à Splunk, Elastic, Sentinel et aux middlewares CEF/Syslog

Authentification

Les requêtes API utilisent une clé API. Vous pouvez créer et gérer vos clés depuis le tableau de bord.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Limites de requêtes

L’accès à l’API est actuellement proposé dans le cadre des intégrations d’entreprise. Les offres en libre-service n’incluent pas de quota pour l’API publique.

Recherche d’exposition

Recherchez des signaux d’exposition indexés via un point de terminaison unique avec authentification.

{
  "type": "email",
  "query": "user@example.com"
}

{
  "success": true,
  "found": true,
  "query": "user@example.com",
  "type": "email",
  "breaches": 3,
  "data": []
}

Domaines surveillés

Listez les enregistrements de surveillance des domaines accessibles au propriétaire de la clé API utilisée pour l’authentification.

{
  "success": true,
  "count": 1,
  "domains": [{
    "id": "domain_123",
    "domain": "example.com",
    "verified": true,
    "status": "active",
    "vulnerabilities": 0,
    "alerts": 0
  }],
  "timestamp": "2026-08-08T00:00:00.000Z"
}

Sécurité des mots de passe par k-anonymat

Vérifiez un préfixe d’empreinte de hachage de mot de passe sans envoyer le mot de passe ni son empreinte complète.

{
  "hashes": {
    "1E4C9B93F3F0682250B6CF8331B7EE68FD8": 12345,
    "ABCDEF0123456789ABCDEF0123456789ABC": 6789
  }
}

Alertes

Listez les alertes de sécurité de l’utilisateur authentifié.

Exemples de code

const axios = require('axios');

async function checkEmail(email) {
  try {
    const response = await axios.post(
      'https://leakdata.io/api/v1/search',
      { type: 'email', query: email },
      {
        headers: {
          'Authorization': 'Bearer YOUR_API_KEY',
          'Content-Type': 'application/json'
        }
      }
    );

    console.log(response.data);
  } catch (error) {
    console.error('Error:', error.response.data);
  }
}

checkEmail('user@example.com');

import requests

response = requests.post(
    'https://leakdata.io/api/v1/search',
    json={'type': 'email', 'query': 'user@example.com'},
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    timeout=30,
)

response.raise_for_status()
print(response.json())

<?php
$payload = json_encode([
    'type' => 'email',
    'query' => 'user@example.com',
]);

$request = curl_init('https://leakdata.io/api/v1/search');
curl_setopt_array($request, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($request);
curl_close($request);

echo $response;

curl --request POST 'https://leakdata.io/api/v1/search' \
  --header "Authorization: Bearer $LEAKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"type":"email","query":"user@example.com"}'

Codes d’erreur

Webhooks

Recevez des notifications automatiques lorsque de nouveaux signaux de violation de données sont détectés.

En-têtes d’envoi

X-Webhook-Signature

Signature HMAC-SHA256 générée à partir du corps JSON brut avec le secret du webhook.

X-LeakData-Signature

Variante de signature sha256= compatible avec les outils SIEM/SOAR.

X-LeakData-Event-Id

Identifiant d’événement stable pour la corrélation et le suivi des nouvelles tentatives.

X-LeakData-Payload-Preset

Format de charge utile sélectionné, tel que splunk_hec, elastic_ecs ou microsoft_sentinel.

X-Webhook-Attempt

Numéro de tentative de livraison pour les récepteurs qui gèrent les nouvelles tentatives.

Charge utile générique

{
  "id": "evt_9f3a7c2e6b1d4a80",
  "type": "domain.alert",
  "created": 1770000000000,
  "data": {
    "domain": "example.com",
    "severity": "high",
    "breachCount": 2
  }
}

SIEM/SOAR

Les webhooks Enterprise peuvent être envoyés dans le format attendu par vos outils de sécurité. Le modèle prédéfini sélectionné modifie le corps JSON transmis et ajoute des en-têtes de compatibilité.

Splunk HEC

{
  "time": 1770000000,
  "source": "leakdata",
  "sourcetype": "leakdata:webhook",
  "event": {
    "id": "evt_splunk",
    "type": "webhook.test",
    "created": 1770000000000,
    "data": {
      "message": "LeakData webhook test notification"
    }
  },
  "fields": {
    "leakdata_event_id": "evt_splunk",
    "leakdata_event_type": "webhook.test",
    "leakdata_preset": "splunk_hec"
  }
}

Microsoft Sentinel

{
  "TimeGenerated": "2026-02-02T02:40:00.000Z",
  "EventId": "evt_sentinel",
  "EventType": "webhook.test",
  "SourceSystem": "LeakData",
  "Severity": 3,
  "RawData": {
    "id": "evt_sentinel",
    "type": "webhook.test",
    "created": 1770000000000,
    "data": {
      "message": "LeakData webhook test notification"
    }
  }
}

Événements des webhooks

Choisissez un ou plusieurs types d’événements lors de la création d’un webhook. Les envois de test utilisent webhook.test et les envois réels utilisent les noms d’événements sélectionnés ci-dessous.