[ API DOCUMENTATION ]

Introduction

L'API Lookup vous permet d'accéder programmatiquement à notre base de données d'informations. Intégrez nos fonctionnalités de recherche directement dans vos applications avec notre API REST sécurisée.

Base URL: https://api.lookup.nailec.fr/v1

Authentification

L'API utilise l'authentification par clé API. Toutes les requêtes doivent inclure votre clé API dans l'en-tête X-API-Key.

curl -X GET "https://api.lookup.nailec.fr/v1/search"
     -H "X-API-Key: votre_clé_api"

Pour obtenir une clé API, vous devez disposer d'un abonnement Premium ou Enterprise. Vous pouvez générer et gérer vos clés API depuis votre tableau de bord.

Limites d'utilisation

Les limites d'utilisation sont basées sur votre plan d'abonnement :

Les en-têtes de réponse incluent des informations sur votre utilisation actuelle :

• X-RateLimit-Limit: Nombre total de requêtes autorisées
• X-RateLimit-Remaining: Nombre de requêtes restantes
• X-RateLimit-Reset: Temps restant avant réinitialisation du compteur (en secondes)

Endpoints

{
  "status": "success",
  "results": 2,
  "data": [
    {
      "id": "12345",
      "type": "email",
      "value": "contact@exemple.com",
      "first_seen": "2021-06-15T10:30:00Z",
      "last_seen": "2023-08-22T14:22:00Z",
      "associated_domains": ["exemple.com", "exemple.org"],
      "breaches": [
        {
          "name": "ExampleDB",
          "date": "2022-03-15",
          "severity": "medium"
        }
      ]
    },
    // ...
  ]
}

{
  "type": "email",
  "value": "contact@exemple.com",
  "alert_level": "high"
}

Exemples d'utilisation

curl -X GET "https://api.lookup.nailec.fr/v1/search?q=exemple.com&type=domain&limit=5" \
     -H "X-API-Key: votre_clé_api"

import requests

api_key = "votre_clé_api"
url = "https://api.lookup.nailec.fr/v1/search"
headers = {
    "X-API-Key": api_key
}
params = {
    "q": "exemple.com",
    "type": "domain",
    "limit": 5
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

print(data)

const fetchData = async () => {
  const apiKey = "votre_clé_api";
  const url = "https://api.lookup.nailec.fr/v1/search?q=exemple.com&type=domain&limit=5";
  
  try {
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'X-API-Key': apiKey
      }
    });
    
    const data = await response.json();
    console.log(data);
  } catch (error) {
    console.error("Erreur:", error);
  }
};

fetchData();

Gestion des erreurs

L'API utilise les codes d'état HTTP standard pour indiquer le succès ou l'échec d'une requête. En cas d'erreur, la réponse inclura un objet JSON avec plus de détails.

{
  "status": "error",
  "code": "rate_limit_exceeded",
  "message": "Vous avez dépassé votre limite de requêtes",
  "details": {
    "reset_in_seconds": 120
  }
}