Documentation de l'API

Intégrez les vérifications d'empreinte numérique à votre application. Recherchez des e-mails, des téléphones, des noms d'utilisateur et plus encore via l'API REST.

Obtenir votre clé APIVoir les points de terminaison

URL de base : https://api.digitalfootprintcheck.com

En-tête d'authentification : Authorization: Basic key-YOUR_API_KEY

Limite de requêtes : 5 000 requêtes par heure

Type de contenu : application/json

Obtenir une clé API

  1. Souscrivez à un abonnement Pro ou Business
  2. Allez dans Compte > Clés API dans votre tableau de bord
  3. Cliquez sur Nouvelle clé API et sélectionnez les autorisations nécessaires
  4. Copiez votre clé (elle commence par key-)

Exemple : créer une recherche

cURL
curl -X POST https://api.digitalfootprintcheck.com/api/search \
  -H "Authorization: Basic key-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identity":"example@gmail.com"}'
JavaScript
const res = await fetch('https://api.digitalfootprintcheck.com/api/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic key-YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ identity: 'example@gmail.com' })
});
const data = await res.json();
console.log(data.data.searchId);
Python
import requests

res = requests.post(
    'https://api.digitalfootprintcheck.com/api/search',
    headers={
        'Authorization': 'Basic key-YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={'identity': 'example@gmail.com'}
)
data = res.json()
print(data['data']['searchId'])

Points de terminaison de l'API

POST/api/search

Lance une recherche et renvoie immédiatement un searchId. Interrogez GET /api/search/:id jusqu'à ce que complete soit true. Consomme 1 crédit.

Corps de la requête

ChampTypeDescription
identitystringE-mail, téléphone, nom d'utilisateur ou nom complet

Réponse (201)

{
  "data": {
    "searchId": "a1b2c3d4-...",
    "identity": "user@example.com",
    "complete": false,
    "paid": true
  }
}
GET/api/search/:id

Interrogez le résultat. Les recherches se terminent généralement en 15 à 60 secondes. Interrogez toutes les 3 secondes.

Réponse une fois terminée (200)

{
  "data": {
    "searchId": "a1b2c3d4-...",
    "identity": "user@example.com",
    "complete": true,
    "report": { "employment": [...], ... }
  }
}

Exemple d'interrogation (JavaScript)

async function pollUntilComplete(searchId) {
  while (true) {
    const res = await fetch(
      'https://api.digitalfootprintcheck.com/api/search/' + searchId,
      { headers: { Authorization: 'Basic key-YOUR_KEY' } }
    );
    const data = (await res.json()).data;
    if (data.complete) return data;
    await new Promise(r => setTimeout(r, 3000));
  }
}
GET/api/search

Liste toutes les recherches de votre compte, les plus récentes en premier.

GET/api/account

Obtenez les détails du compte : offre, crédits restants, statut de l'abonnement.

GET/api/user

Obtenez les informations du profil utilisateur.

GET/api/key

Liste toutes les clés API (masquées). Utilisez GET /api/key/:id pour afficher une clé complète.

Codes d'erreur

StatutSignification
401Clé API invalide ou absente
402Crédits insuffisants : passez à une offre supérieure
403La clé API ne dispose pas de l'autorisation requise
429Limite de requêtes dépassée : patientez puis réessayez
500Erreur serveur : contactez le support si le problème persiste

Prêt à développer ?

Souscrivez à un abonnement Pro ou Business, créez une clé API et commencez l'intégration en quelques minutes.

Voir les tarifsGérer les clés API