Premiers pas

EmailKind est une API REST qui classifie les adresses email par fournisseur et type. Ce guide vous aidera a demarrer en quelques minutes.

1. Creer un compte

Inscrivez-vous sur emailkind.com/fr/register pour obtenir votre cle API gratuite. Le plan gratuit inclut 100 requetes par mois.

2. Obtenir votre cle API

Apres inscription, rendez-vous dans votre Tableau de bord > Cles API et creez une nouvelle cle. Votre cle ressemblera a :

sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345

Important : Copiez et stockez votre cle en lieu sur. Elle ne sera affichee qu'une seule fois.

3. Faire votre premiere requete

curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  "https://emailkind.com/v1/classify?email=john@google.com"

4. Lire la reponse

{
  "success": true,
  "request_id": "req_abc123",
  "email": "john@google.com",
  "domain": "google.com",
  "provider": {
    "id": "google_workspace",
    "name": "Google Workspace",
    "type": "business"
  },
  "classification": {
    "is_business": true,
    "is_free": false,
    "is_disposable": false,
    "is_education": false,
    "is_custom_domain": true,
    "is_role": false
  },
  "mx": [
    "smtp.google.com",
    "smtp2.google.com"
  ],
  "confidence": 0.98,
  "cached": false
}

5. Integrer avec un SDK

Installez le SDK officiel pour votre langage :

Python (PyPI)

pip install emailkind

from emailkind import EmailKind

client = EmailKind("sk_live_VOTRE_CLE")
result = client.classify(email="ceo@stripe.com")
print(result.provider.name)                # "Google Workspace"
print(result.classification.is_business)   # True

Node.js (npm)

npm install emailkind

import EmailKind from 'emailkind';

const client = new EmailKind('sk_live_VOTRE_CLE');
const result = await client.classify({ email: 'ceo@stripe.com' });
console.log(result.provider.name);             // "Google Workspace"
console.log(result.classification.is_business); // true

Go (pkg.go.dev)

go get github.com/gastonmedia/emailkind-go

client := emailkind.NewClient("sk_live_VOTRE_CLE")
result, _ := client.Classify(ctx, &emailkind.ClassifyParams{
    Email: "ceo@stripe.com",
})
fmt.Println(result.Provider.Name) // "Google Workspace"

Consultez la documentation complete des SDKs pour la classification par lot, les regles personnalisees, le traitement bulk et la gestion des erreurs.

Autres langages

Vous pouvez aussi utiliser l'API REST directement. Voir la reference de l'endpoint Classify pour des exemples cURL, PHP et Ruby.

Etapes suivantes