Documentation API

Déployez la vérification des emails en un clic

Appeler l’API

Effectuez une requête GET au point de terminaison suivant : 

curl -X GET \
"https://api.bouncestrike.com?apikey=YOUR_API_KEY&email=test@example.com"

Remplacez YOUR_API_KEY par votre clé API personnelle.

Paramètres de la demande

Paramètre Type Description Requis
apikey string Votre clé API personnelle Oui
email string L’adresse email à vérifier Oui

Exemple de réponse

{
  "status": "Success",
  "message": "Email verification completed successfully.",
  "verification": {
    "address": "test@example.com",
    "local_part": "test",
    "domain": "example.com",
    "accept_all_policy": false,
    "is_role_account": false,
    "is_free_provider": true,
    "is_disposable": false,
    "is_spamtrap": false,
    "deliverable": false
  },
  "credits_used": 12,
  "credits_left": 88,
  "next_reset": "2025-08-31"
}

Paramètres de réponse

Paramètre Type Description
status string « Success » ou « Error »
message string Description du résultat
verification object Détails de la vérification de l’email
verification.address string L’adresse email vérifiée
verification.local_part string Partie locale de l’email
verification.domain string Domaine de l’email
verification.accept_all_policy boolean True si l’hôte distant accepte le courrier à n’importe quelle adresse
verification.is_role_account boolean True s’il s’agit d’un compte de rôle (info@, sales@)
verification.is_free_provider boolean True s’il s’agit d’un fournisseur de messagerie gratuit
verification.is_disposable boolean True si c’est un email jetable
verification.is_spamtrap boolean True s’il s’agit d’un spamtrap ou d’une adresse blacklist
verification.deliverable boolean True si l’email est livrable
credits_used integer Nombre de crédits utilisés jusqu’à présent
credits_left integer Crédits mensuels restants
next_reset string (YYYY-MM-DD) Date de réinitialisation des crédits

Codes d’erreur

Code HTTP Erreur Description
400 Invalid email address Le paramètre email est manquant ou invalide
401 Missing API key Aucune clé API fournie dans la demande
403 Invalid API key / Inactive subscription La clé API est erronée ou l’abonnement est inactif
429 Quota exceeded Vos crédits mensuels sont épuisés
429 Too many requests Vous avez dépassé la limite de débit (par seconde)
500/503 Service temporarily unavailable Erreur de service ou de connexion BounceStrike