🔌 API — Documentation

L'outil est accessible via une API publique qui retourne au format JSON le même résultat que l'interface web.

📡 Endpoint

GET https://quihebergelesmails.fr/api/check?domain=example.fr

⚙️ Paramètres

Paramètre	Type	Description
`domain`	string, requis	Le nom de domaine à analyser (ex : `exemple.fr`)

Pour s'authentifier avec un token, ajouter le header :

Authorization: Bearer votre_token_ici

⏱️ Limites de requêtes

Accès	Limite
Public	50 requêtes / jour par IP
Avec token	Quota personnalisé (jusqu'à 500 req/jour)

💻 Exemples curl

Requête simple (sans token) :

curl "https://quihebergelesmails.fr/api/check?domain=ezeo.coop"

Avec un token d'authentification :

curl -H "Authorization: Bearer votre_token_ici" \ "https://quihebergelesmails.fr/api/check?domain=ezeo.coop"

Filtrer les champs avec jq (domaine, hébergeur, pays) :

curl -s -H "Authorization: Bearer votre_token_ici" \ "https://quihebergelesmails.fr/api/check?domain=ezeo.coop" \ | jq '{domain: .domain, hebergeur: .result.hebergeur, country: .result.smtp.country}'

📄 Exemple de réponse

{ "domain": "example.fr", "authenticated": false, "result": { "detection_type": "simple", "hebergeur": "OVH - Entreprise française 🇫🇷", "confidence": "high", "detection_method": "MX", "antispam": null, "smtp": { "banner": "220 mail.example.fr ESMTP Postfix", "server": "Postfix (logiciel libre)", "ip": "1.2.3.4", "country": "France 🇫🇷" }, ... } }

Les champs detection_type possibles : simple, antispam_found, antispam_unknown, self_hosted, unknown.

⚠️ Codes d'erreur

Code HTTP	Cause
`400`	Paramètre `domain` manquant
`401`	Token invalide
`404`	Domaine sans enregistrement MX ou inexistant
`422`	Format de domaine invalide
`429`	Quota journalier dépassé
`500`	Erreur interne

📣 Attribution

Si vous intégrez cette API dans un outil ou service accessible au public, nous vous demandons de mentionner la source dans votre interface ou vos résultats, par exemple :

Données fournies par quihebergelesmails.fr

🔑 Obtenir un token

L'accès public est suffisant pour un usage ponctuel. Si vous avez besoin d'un volume plus important — intégration dans un outil, traitement en masse, projet associatif ou de recherche — vous pouvez nous demander un token gratuitement.

Contactez-nous via ezeo.coop/nous-contacter en nous indiquant dans quel but vous souhaitez utiliser l'API (outil interne, projet open source, étude, etc.). Nous étudierons votre demande et pourrons vous attribuer un token gratuitement, selon le projet.

← Retour à l'outil