Référence API

Authentification de l'API REST, base URL, pagination et référence OpenAPI complète des endpoints de recherche et de vérification de fuites Stealed.

L'API publique de Stealed expose des endpoints en lecture seule pour la recherche et la vérification de fuites. Les opérations de gestion (monitors, canaux, domaines, mots-clés, membres) restent à la portée du dashboard avec une session utilisateur authentifiée.

Base URL

https://api.stealed.io

Tous les endpoints sont en HTTPS uniquement. HTTP est rejeté.

Authentification

Chaque requête porte une clé API dans l'en-tête X-Api-Key.

curl -H "X-Api-Key: $STEALED_API_KEY" \
  https://api.stealed.io/leaks/me

Créer une clé API

Les clés API sont scopées par organisation. Pour en créer une :

Ouvrez le dashboard sur app.stealed.io.
Allez dans Settings → API Integration.
Cliquez sur New API key, donnez-lui un nom descriptif (par exemple "splunk ingestion") et cliquez sur Create.
Copiez la clé immédiatement. Le secret complet n'est affiché qu'une seule fois. Ensuite vous pouvez voir le préfixe dans le dashboard mais pas la valeur complète.

Page Settings → API Integration avec la liste des clés et le flux de création

Permissions

Une clé donne accès à :

GET /leaks/* : recherche de fuites, statistiques, recherche par mot-clé.
POST /api-keys/verify : valider une clé et lire les métadonnées de l'organisation.

Les endpoints de gestion (monitors, canaux, domaines, mots-clés, équipe, CRUD des clés API) ne sont PAS dans la surface API publique. Ils nécessitent une session utilisateur dans le dashboard.

Faire tourner une clé

Pour faire une rotation, créez une nouvelle clé, déployez-la dans votre intégration, puis supprimez l'ancienne depuis le dashboard. Les clés prennent effet immédiatement à la création et sont invalidées immédiatement à la suppression.

Révoquer une clé compromise

Vous suspectez qu'une clé a fuité ? Supprimez-la depuis Settings → API Integration. La suppression est effective immédiatement pour les nouvelles requêtes. Les requêtes déjà en cours avec cette clé se terminent normalement.

Pagination

L'endpoint /leaks/details retourne des résultats paginés :

{
  "data": [...],
  "total": 12345,
  "page": 1,
  "page_size": 50,
  "total_pages": 247
}

page_size par défaut : 50
page_size maximum : 200
La pagination est offset-based, pas cursor-based : pour de très gros exports, bornez vos requêtes avec start_date et end_date plutôt que de paginer sur des millions de lignes.

Fenêtre temporelle

Les endpoints /leaks/* ciblent par défaut les 14 derniers jours quand ni start_date ni end_date n'est fourni. Format : YYYY-MM-DD. Les deux paramètres peuvent être spécifiés indépendamment.

Limites de débit

Par clé API :

60 requêtes / minute (burst toléré jusqu'à 100)
5 000 requêtes / heure
100 000 requêtes / jour

Quand vous atteignez une limite, l'API retourne 429 Too Many Requests avec un en-tête Retry-After (en secondes). Faites du backoff et retentez.

Erreurs

Les erreurs suivent le RFC 9457 Problem Details :

{
  "type": "https://api.stealed.io/errors/invalid-domain",
  "title": "Invalid domain",
  "status": 400,
  "detail": "The domain 'acme' is not in your watchlist.",
  "instance": "/leaks/details"
}

Statuts HTTP courants :

Statut	Signification
200	Succès
400	Erreur de validation (voir `detail`)
401	Clé API manquante ou invalide
403	Clé valide mais n'autorise pas cette opération
404	Ressource non trouvée
429	Limite de débit dépassée
500	Erreur interne, retentez avec backoff exponentiel

Référence des endpoints

La référence OpenAPI complète (avec les schémas, paramètres et try-it-now) est générée plus bas depuis la spec en direct. Chaque opération a sa propre page.

Leaks : recherche, détail, statistiques, recherche par mot-clé.
API Keys : endpoint de vérification.

La spec OpenAPI est aussi disponible sur api.stealed.io/openapi.json pour la génération de code et de SDK.

On this page