API Dokümantasyonu

LeakData ile güvenli entegrasyonlar geliştirin

Veri sızıntılarını kontrol edin, kullanıcılarınızı koruyun ve güvenlik uyarıları alın.

Başlangıç noktaları

Ne yapmak istiyorsunuz?

Hedefinizi seçin; sizi doğrudan ilgili endpoint, güvenlik notu ve uygulama örneğine götürelim.

Hızlı başlangıç3 adımda ilk istek

Kimlik doğrulamadan geçerli isteğe uzanan en kısa uygulama yolu.

1
Kimlik doğrulama
Her istekte API anahtarınızı Bearer başlığıyla gönderin.
Authorization: Bearer YOUR_API_KEY
2
Örnek istek
Maruziyet aramasına kimliği doğrulanmış bir POST isteği gönderin.
3
Yanıtı işleyin
Dönen maruziyet sinyallerini ve kaynakları uygulamanızın iş akışına alın.

Uç nokta dizini

API referansı

Yayınlanan v1 endpointlerini tek bakışta inceleyin ve ayrıntılı bölüme geçin.

OpenAPI tanımı

Giriş

LeakData.io API, uygulamalarınıza veri sızıntısı kontrolü ve güvenlik izleme iş akışı eklemenizi sağlar.

Temel URL: https://leakdata.io/api/v1

Özellikler

İndekslenen sızıntı verileri üzerinde maruziyet sinyali arama
E-posta, telefon, kullanıcı adı ve domain için tek arama endpointi
Dashboard üzerinden API anahtarı oluşturma
Yönetilen entegrasyonlar için kurumsal API/webhook erişimi
Splunk, Elastic, Sentinel ve CEF/Syslog ara katmanlarına imzalı SIEM/SOAR payload gönderimi

Kimlik Doğrulama

API istekleri için API anahtarı kullanılır. Anahtarlarınızı dashboard üzerinden oluşturup yönetebilirsiniz.

İstek Başlıkları

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Güvenlik Uyarısı: API anahtarınızı asla istemci tarafı kodunda veya public repositorylerde paylaşmayın.

Hız Sınırları

API erişimi şu anda kurumsal entegrasyon paketiyle verilir. Self-servis planlarda public API kotası yoktur.

Paket	Dakika Başı	Günlük	Aylık
Free	—	—	Dahil değil
Pro / Elite	—	—	Dahil değil
Enterprise	Sözleşme	Sözleşme	Sözleşme

Maruziyet araması

Kimliği doğrulanmış tek endpoint üzerinden indekslenen maruziyet sinyallerini arayın.

POST/search

Desteklenen arama türleri: e-posta, telefon, kullanıcı adı ve domain.

İstek Gövdesi

JSON

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

Yanıt

JSON

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

İzlenen domainler

Kimliği doğrulanmış API anahtarı sahibinin erişebildiği domain izleme kayıtlarını listeleyin.

GET/domains

Yanıt

JSON

{
  "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"
}

k-Anonimlik ile parola güvenliği

Parolayı veya tam hash değerini göndermeden parola hash ön ekini kontrol edin.

Büyük harfe dönüştürülmüş SHA-1 hash değerinin yalnızca ilk beş karakterini gönderin. LeakData özgün parolayı veya tam hash değerini hiçbir zaman almaz.

GET/password/check/5BAA6

Yanıt

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

Uyarılar

Kimliği doğrulanan kullanıcının güvenlik uyarılarını listeleyin.

GET/alerts

Sorgu Parametreleri

limit - Döndürülecek en fazla kayıt (varsayılan: 10, en fazla: 100)
status - Durum filtresi (read, unread, all)
severity - Önem filtresi (low, medium, high, critical)

Kod Örnekleri

JavaScript (Node.js)

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');

Python (requests)

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 (cURL)

<?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

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

Hata Kodları

Kod	Açıklama
`400`	Bad Request - Geçersiz istek parametreleri
`401`	Unauthorized - Geçersiz veya eksik API anahtarı
`403`	Forbidden - Yetkisiz erişim
`429`	Too Many Requests - Rate limit aşıldı
`500`	Internal Server Error - Sunucu hatası

Webhooks

Yeni sızıntılar tespit edildiğinde otomatik bildirim alın.

Webhook URL ve payload formatını dashboard üzerinden yapılandırabilirsiniz. LeakData imzalı POST teslimatı gönderir ve yeniden denenebilir hataları operasyon takibi için saklar.

Teslimat başlıkları

X-Webhook-Signature: Webhook secret ile ham JSON gövde üzerinden üretilen HMAC-SHA256 imzası.
X-LeakData-Signature: SIEM/SOAR araçları için sha256= prefix ile gönderilen uyumlu imza varyantı.
X-LeakData-Event-Id: Korelasyon ve yeniden deneme takibi için sabit olay kimliği.
X-LeakData-Payload-Preset: splunk_hec, elastic_ecs veya microsoft_sentinel gibi seçilen payload formatı.
X-Webhook-Attempt: Retry destekli hedefler için teslimat deneme sayısı.

Genel payload

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

SIEM/SOAR

Kurumsal webhooklar güvenlik aracınızın beklediği formatta gönderilebilir. Seçilen preset, iletilen JSON gövdesini ve uyumluluk başlıklarını değiştirir.

LeakData JSON

generic

Varsayılan imzalı JSON payload. Tüm olay alanları LeakData şemasında kalır.

Hedef: Özel webhook receiver, SOAR playbook
Başlık: X-LeakData-Payload-Preset

Splunk HEC

splunk_hec

Splunk HTTP Event Collector uyumlu time, source, sourcetype, event ve fields alanlarıyla hazırlanır.

Hedef: Splunk HTTP Event Collector
Başlık: X-Splunk-Request-Channel

Elastic ECS

elastic_ecs

Elastic ECS uyumlu event, observer, threat, rule ve leakdata alanlarını kullanır.

Hedef: Elastic ECS ingest
Başlık: X-Elastic-Event-Dataset

Microsoft Sentinel

microsoft_sentinel

Log Analytics custom table akışına uyumlu TimeGenerated, EventId, EventType, Severity ve RawData alanlarıyla hazırlanır.

Hedef: Microsoft Sentinel özel günlüğü
Başlık: Log-Type

CEF / Syslog

cef_syslog

Syslog veya SOAR relay katmanlarına uyumlu CEF mesajını JSON içinde taşır.

Hedef: CEF, Syslog veya SOAR ara katmanı
Başlık: X-CEF-Product

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"
    }
  }
}

Webhook olayları

Webhook oluştururken bir veya daha fazla olay tipi seçilir. Test teslimatları webhook.test, gerçek teslimatlar aşağıdaki seçilen olay adlarıyla gönderilir.

breach.detectedSızıntı eşleşmesiİzlenen kimlik verisi sızıntı verisinde bulunduğunda gönderilir.

breach.newYeni ihlal kaydıLeakData veri setine yeni bir ihlal kaydı eklendiğinde gönderilir.

domain.alertDomain alarmıİzlenen şirket domaini risk sinyali ürettiğinde gönderilir.

search.foundArama sonucu bulunduAPI araması veya izleme akışı eşleşme döndürdüğünde gönderilir.

monitoring.alertİzleme uyarısıE-posta, domain veya hesap izleme kuralı alarm ürettiğinde gönderilir.

account.suspiciousŞüpheli hesap olayıHesap güvenliğiyle ilgili olağan dışı aktivite görüldüğünde gönderilir.

api.limit.warningAPI limit uyarısıKurumsal API kullanımı önemli bir eşiğe yaklaştığında gönderilir.

Hızlı başlangıç

3 adımda ilk istek

Kimlik doğrulamadan geçerli isteğe uzanan en kısa uygulama yolu.

1
Kimlik doğrulama
Her istekte API anahtarınızı Bearer başlığıyla gönderin.
Authorization: Bearer YOUR_API_KEY

Örnek istek

Maruziyet aramasına kimliği doğrulanmış bir POST isteği gönderin.

cURL

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

3
Yanıtı işleyin
Dönen maruziyet sinyallerini ve kaynakları uygulamanızın iş akışına alın.

Yardıma mı ihtiyacınız var?

Entegrasyon konusunda destek almak için iletişime geçin.

İletişim

Bu site çerezleri kullanıyor

Ne yapmak istiyorsunuz?

Kimlik doğrulama

Örnek istek

Yanıtı işleyin

API referansı

Giriş

Özellikler

Kimlik Doğrulama

Hız Sınırları

Maruziyet araması

İstek Gövdesi

Yanıt

İzlenen domainler

Yanıt

k-Anonimlik ile parola güvenliği

Yanıt

Uyarılar

Sorgu Parametreleri

Kod Örnekleri

Hata Kodları

Webhooks

Teslimat başlıkları

Genel payload

SIEM/SOAR

LeakData JSON

Splunk HEC

Elastic ECS

Microsoft Sentinel

CEF / Syslog

Splunk HEC

Microsoft Sentinel

Webhook olayları