Référence Développeur

Liste Noire de Courrier

Consultez la documentation de l'API Liste Noire de Courrier, ses paramètres de requête, les champs de réponse, les exemples de code et la gestion des erreurs pour les intégrations DomScan.

Liste Noire de Courrier

API de validation de courrier électronique global pour détecter les adresses de courrier jetables/temporaires, les adresses basées sur les rôles, les fournisseurs gratuits et vérifier la réputation du domaine. Notre base de données contient 80 000+ domaines de courrier jetables avec scoring de confiance élevée/moyenne/faible. Essentiel pour la prévention de la fraude d'inscription et le filtrage de la qualité des pistes.

GET /v1/email/check

Paramètres de Requête

Paramètre	Type	Description
email requis	string	Adresse de courrier à vérifier (par exemple, "[email protected]")
checks optionnel	string	Vérifications séparées par des virgules à exécuter : `disposable`, `role`, `free`, `mx`, `dnsbl`. Par défaut : toutes

Vérifications Disponibles

Vérifier	Description	Points de risque
`disposable`	Vérification par rapport à la base de données de 80 000+ domaines jetables	+80
`role`	Détecte les adresses basées sur un rôle (admin@, support@, etc.)	+20
`free`	Identifie les fournisseurs de courrier électronique gratuits (gmail, yahoo, etc.)	+10
`mx`	Valide que les enregistrements MX existent pour le domaine	+50 (si aucun)
`dnsbl`	Vérifie le domaine par rapport aux listes noires DNS (Spamhaus, etc.)	+15-60

Niveaux de Risque

Faible (0-39) :: Sûr à accepter
Moyen (40-69) :: Examen recommandé
Élevé (70-100) :: Probablement frauduleux/temporaire

Exemple de Requête

# Full check (all validations)
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/[email protected]"

# Quick disposable check only
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/[email protected]&checks=disposable"

import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.get(
    "https://domscan.net/v1/email/check",
    params={"email": "[email protected]"}
)
data = response.json()

if data['risk_level'] == 'high':
    print(f"Reject: {data['flags']}")
elif data['checks']['disposable']['is_disposable']:
    print("Disposable email detected")

Exemple de Réponse

{
  "email": "[email protected]",
  "domain": "tempmail.com",
  "local_part": "user",
  "valid_syntax": true,
  "checks": {
    "disposable": {
      "is_disposable": true,
      "confidence": "high"
    },
    "role": {
      "is_role": false,
      "role_type": null
    },
    "free": {
      "is_free": false,
      "provider": null
    },
    "mx": {
      "has_mx": true,
      "records": ["mx.tempmail.com"]
    },
    "dnsbl": {
      "listed": false,
      "threat_level": "none"
    }
  },
  "risk_score": 80,
  "risk_level": "high",
  "flags": ["DISPOSABLE_DOMAIN"],
  "checked_at": "2025-01-15T12:00:00Z"
}

Champs de Réponse

Champ	Type
`email`	string
`domain`	string
`local_part`	string
`valid_syntax`	boolean
`checks`	object
`checks.disposable`	object
`checks.disposable.is_disposable`	boolean
`checks.disposable.confidence`	string \| null
`checks.role`	object
`checks.role.is_role`	boolean
`checks.role.role_type`	string \| null
`checks.free`	object
`checks.free.is_free`	boolean
`checks.free.provider`	string \| null
`checks.mx`	object
`checks.mx.has_mx`	boolean
`checks.mx.records[]`	string[]
`checks.dnsbl`	object
`checks.dnsbl.listed`	boolean
`checks.dnsbl.threat_level`	string
`risk_score`	integer
`risk_level`	string
`flags[]`	string[]
`checked_at`	string

POST /v1/email/check/bulk

Corps de la requête

Paramètre	Type	Description
emails requis	string[]	Tableau d'adresses électroniques à vérifier (max 100 par requête)
checks optionnel	string[]	Vérifications à exécuter : ["jetable", "rôle", "gratuit", "mx", "dnsbl"]

Cas d'utilisation

Nettoyez les listes de courrier électronique avant les campagnes marketing
Validez les enregistrements d'utilisateurs en temps réel
Notez les prospects par qualité de courrier électronique
Détectez les modèles de fraude d'inscription

Exemple de Requête

curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/email/check/bulk" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "[email protected]",
      "[email protected]",
      "[email protected]"
    ],
    "checks": ["disposable", "role"]
  }'

Exemple de Réponse

{
  "results": [
    {
      "email": "[email protected]",
      "risk_level": "low",
      "risk_score": 10,
      "flags": ["FREE_PROVIDER"]
    },
    {
      "email": "[email protected]",
      "risk_level": "high",
      "risk_score": 80,
      "flags": ["DISPOSABLE_DOMAIN"]
    },
    {
      "email": "[email protected]",
      "risk_level": "medium",
      "risk_score": 20,
      "flags": ["ROLE_ADDRESS"]
    }
  ],
  "summary": {
    "total": 3,
    "disposable": 1,
    "role_based": 1,
    "free_provider": 1,
    "high_risk": 1,
    "medium_risk": 1,
    "low_risk": 1
  },
  "checked_at": "2025-01-15T12:00:00Z"
}

Champs de Réponse

Champ	Type
`results[]`	object[]
`results[]`	object
`summary`	object
`summary.total`	integer
`summary.disposable`	integer
`summary.role_based`	integer
`summary.free_provider`	integer
`summary.no_mx`	integer
`summary.dnsbl_listed`	integer
`summary.high_risk`	integer
`summary.medium_risk`	integer
`summary.low_risk`	integer
`checked_at`	string

GET /v1/email/blacklist

Paramètres de Requête

Paramètre	Type	Description
limit optionnel	number	Nombre de domaines à retourner (défaut : 1 000, max : 10 000)
offset optionnel	number	Décalage de pagination (par défaut : 0)
format optionnel	string	`json` (par défaut) ou `txt` pour la liste en texte brut

Description

Téléchargez notre liste noire de domaines de courrier électronique jetables. Gratuit pour tous les utilisateurs. Utilisez /v1/email/blacklist/download pour la liste complète comme fichier téléchargeable.

Exemple de Requête

# Get first 1000 domains as JSON
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist"

# Get as plain text for firewall rules
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist?format=txt&limit=5000"

# Download complete blacklist
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/blacklist/download" -o disposable.json

Exemple de Réponse

{
  "domains": [
    "tempmail.com",
    "guerrillamail.com",
    "10minutemail.com",
    "mailinator.com",
    "..."
  ],
  "total": 85432,
  "offset": 0,
  "limit": 1000,
  "metadata": {
    "last_updated": "2025-01-15T00:00:00Z",
    "total_domains": 85432,
    "high_confidence_count": 12500,
    "wildcard_count": 234,
    "sources": [
      "disposable-email-domains",
      "ivolo/disposable-email-domains"
    ]
  }
}

Champs de Réponse

Champ	Type
`domains[]`	string[]
`total`	integer
`offset`	integer
`limit`	integer
`metadata`	object
`metadata.last_updated`	string
`metadata.total_domains`	integer
`metadata.high_confidence_count`	integer
`metadata.wildcard_count`	integer
`metadata.sources[]`	string[]
`metadata.source_count`	integer
`metadata.successful_source_count`	integer
`metadata.failed_source_count`	integer
`metadata.refresh_cadence_hours`	integer
`metadata.refresh_status`	string
`metadata.next_refresh_due`	string
`metadata.dataset_status`	string
`metadata.quality_policy_version`	integer \| null
`metadata.quarantined_domain_count`	integer
`metadata.rejected_domain_count`	integer

GET /v1/email/blacklist/download

Paramètres de Requête

Paramètre	Type	requis
format	string Valeurs autorisées `jsontxt` Défaut `json`	optionnel

Champs de Réponse

Champ	Type
`domains[]`	string[]
`wildcards[]`	string[]
`metadata`	object

Exemple de Requête

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/blacklist/download?format=json"

Exemple de Réponse

{
  "domains": [
    "example.com",
    "example.org"
  ],
  "wildcards": [
    "example"
  ],
  "metadata": {}
}