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. Obtenir une cle API
Le plan gratuit inclut 100 requetes par mois. Il y a deux facons d'obtenir une cle, et elles donnent le meme resultat.
Dans un navigateur
Inscrivez-vous sur emailkind.com/fr/register, puis rendez-vous dans Tableau de bord > Cles API et creez une cle.
Depuis un script ou un agent IA
Deux requetes, sans navigateur et sans etape humaine. La premiere vous envoie un code court par email, la seconde l'echange contre une cle.
curl -X POST https://emailkind.com/v1/signup \
-H "Content-Type: application/json" \
-d '{"email": "vous@exemple.com", "lang": "fr"}'
curl -X POST https://emailkind.com/v1/signup/confirm \
-H "Content-Type: application/json" \
-d '{"email": "vous@exemple.com", "code": "K7M2QXAB"}'
Le second appel renvoie la cle :
{
"success": true,
"api_key": "sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345",
"plan": "free",
"monthly_limit": 100,
"burst_limit": 10
}
Voir Authentification pour la reference complete, codes d'erreur et limites inclus.
Dans les deux cas : copiez et stockez votre cle en lieu sur. Elle n'est affichee qu'une seule fois.
2. Faire votre premiere requete
curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
"https://emailkind.com/v1/classify?email=john@google.com"
3. 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
}
4. 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
- Installez un SDK officiel pour Python, Node.js ou Go
- Apprenez-en plus sur l'Authentification
- Consultez la reference complete de l'endpoint Classify
- Comprenez la Gestion des erreurs
- Consultez les Limites de debit de votre plan