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/[email protected]"

4. Lire la reponse

{
  "success": true,
  "request_id": "req_abc123",
  "email": "[email protected]",
  "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
  },
  "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="[email protected]")
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: '[email protected]' });
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: "[email protected]",
})
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