IPScanner

Agentscan

Vérification d'e-mail

Vérifiez une adresse avant d'accepter une inscription : syntaxe, domaines jetables, serveurs de messagerie, fautes de frappe et adresses génériques.

Vérifier une adresse e-mail

POST/v1/email/check
Clé API1 requête

Paramètres

  • emailstringObligatoire

    L'adresse à vérifier, 320 octets au plus. GET la prend en ?email=.

Champs de la réponse

  • emailstring

    L'adresse vérifiée, domaine en minuscules.

  • statusstring

    valid, invalid, risky ou unknown.

  • reasonstring | null

    Pourquoi : syntax, no_mx, null_mx, disposable, typo, role, dns_error ou quota. null si valid.

  • suggestionstring | null

    L'adresse avec le domaine de webmail corrigé, quand le domaine ressemble à une faute de frappe.

  • domainstring

    Le domaine en ASCII (IDN converti).

  • checksobject

    Chaque vérification derrière le statut.

  • checks.mxboolean | null

    Le domaine reçoit des e-mails. null si le DNS n'a pas été interrogé ou n'a pas répondu.

  • checks.disposableboolean

    Le domaine fournit des boîtes jetables.

  • checks.roleboolean

    Une boîte partagée comme info@ ou support@.

  • checks.freeProviderboolean

    Un webmail gratuit comme Gmail ou Outlook.

  • mailboxstring

    Toujours not_checked : la boîte elle-même n'est pas sondée.

curl -X POST https://ipscanner.io/v1/email/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@outlok.com"}'
Réponse
{
  "email": "jane@outlok.com",
  "status": "risky",
  "reason": "typo",
  "suggestion": "jane@outlook.com",
  "domain": "outlok.com",
  "checks": {
    "syntax": true,
    "mx": true,
    "disposable": false,
    "role": false,
    "freeProvider": false
  },
  "mailbox": "not_checked"
}