KryptaScope API

Intégrez la surveillance de fuites de données dans vos outils existants. Authentifiez-vous avec une clé API générée depuis votre dashboard.

Authentification

Toutes les requêtes doivent inclure le header Authorization: Bearer <votre_clé>

Permissions :
read — Lecture des fuites, scores, alertes
scan — Déclenchement de scans manuels

Rate limiting : 60 requêtes par minute par clé API.

GET/api/v1/leaksread

Liste paginée des fuites email, avec filtres.

Paramètres

domainIdstringFiltrer par domaine (optionnel, sinon tous les domaines)

severitystringFiltrer par sévérité : LOW, MEDIUM, HIGH, CRITICAL

resolvedstring"true" ou "false" pour filtrer par statut

pagenumberNuméro de page (défaut : 1)

limitnumberRésultats par page (défaut : 50, max : 200)

Exemple

curl -H "Authorization: Bearer ks_live_xxx" \
  "https://kryptascope.com/api/v1/leaks?severity=HIGH&resolved=false"

Réponse

{
  "leaks": [
    {
      "id": "clx...",
      "email": "john@example.com",
      "breachName": "Example Breach 2019",
      "breachDate": "2019-05-01",
      "dataTypes": ["email", "password"],
      "passwordExposed": true,
      "severity": "HIGH",
      "detectedAt": "2026-04-13T...",
      "resolved": false,
      "resolvedAt": null
    }
  ],
  "pagination": { "total": 46, "page": 1, "pages": 1, "limit": 50 }
}

GET/api/v1/scoreread

Score de sécurité actuel (0-100, plus haut = mieux), niveau de risque et historique.

Paramètres

domainIdstringFiltrer par domaine (optionnel)

Exemple

curl -H "Authorization: Bearer ks_live_xxx" \
  "https://kryptascope.com/api/v1/score"

Réponse

{
  "scores": {
    "domain": "example.com",
    "domainId": "clx...",
    "securityScore": 55,
    "riskLabel": "medium",
    "lastChecked": "2026-04-13T...",
    "leaks": { "active": 24, "resolved": 12, "total": 36 },
    "history": [
      { "securityScore": 80, "riskLabel": "low", "createdAt": "2026-03-01" },
      { "securityScore": 55, "riskLabel": "medium", "createdAt": "2026-04-01" }
    ]
  }
}

GET/api/v1/alertsread

Historique des alertes envoyées.

Paramètres

pagenumberNuméro de page (défaut : 1)

limitnumberRésultats par page (défaut : 50, max : 200)

Exemple

curl -H "Authorization: Bearer ks_live_xxx" \
  "https://kryptascope.com/api/v1/alerts"

Réponse

{
  "alerts": [
    {
      "id": "clx...",
      "channel": "EMAIL",
      "trigger": "NEW_LEAK",
      "status": "SENT",
      "sentAt": "2026-04-13T...",
      "payload": { "domain": "example.com", "leakCount": 3 }
    }
  ],
  "pagination": { "total": 15, "page": 1, "pages": 1 }
}

POST/api/v1/scanscan

Déclenche une analyse complète (fuites email + code public). L'analyse tourne en arrière-plan.

Paramètres

domainIdstringIdentifiant du domaine à analyser (requis) *

Exemple

curl -X POST -H "Authorization: Bearer ks_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"domainId":"clx..."}' \
  "https://kryptascope.com/api/v1/scan"

Réponse

{
  "success": true,
  "message": "Scan started for example.com. Results will be available from GET /api/v1/leaks.",
  "domainId": "clx...",
  "domain": "example.com"
}

KryptaScope API — Questions ? Contact