Authentification
Toutes les requêtes doivent inclure votre API key dans les paramètres de requête.
?apikey={{ exampleApiKey }}
Important
Le domaine de votre senderEmail doit être autorisé par votre abonnement.
Envoyer un Email
Endpoint
POST {{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}
Paramètres du corps
| Champ | Type | Requis | Description |
|---|---|---|---|
| senderName | string | oui | Nom de l'expéditeur |
| receiverEmail | string | oui | Email du destinataire |
| subject | string | oui | Sujet de l'email |
| body | string | oui | Contenu HTML de l'email |
| senderEmail | string | oui | Email d'envoi (doit utiliser un domaine autorisé) |
| password | string | oui | Mot de passe du compte email |
| host | string | oui | Serveur SMTP (ex: mail.votre-domaine.com) |
Exemple de requête
{
"senderName": "MailShipper",
"receiverEmail": "client@example.com",
"subject": "Bienvenue sur notre plateforme",
"body": "<h1>Bonjour!</h1><p>Merci de vous inscrire.</p>",
"senderEmail": "contact@votre-domaine.com",
"password": "votre_mot_de_passe",
"host": "mail.votre-domaine.com"
}
Exemples de code
curl -X POST '{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}' \
-H "Content-Type: application/json" \
-d '{
"senderName": "MailShipper",
"receiverEmail": "client@example.com",
"subject": "Bienvenue",
"body": "<h1>Bonjour!</h1>",
"senderEmail": "contact@votre-domaine.com",
"password": "votre_mot_de_passe",
"host": "mail.votre-domaine.com"
}'
const response = await fetch(
'{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}',
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
senderName: 'MailShipper',
receiverEmail: 'client@example.com',
subject: 'Bienvenue',
body: '<h1>Bonjour!</h1>',
senderEmail: 'contact@votre-domaine.com',
password: 'votre_mot_de_passe',
host: 'mail.votre-domaine.com'
})
}
);
const data = await response.json();
console.log(data);
import requests
response = requests.post(
'{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource',
params={'apikey': '{{ exampleApiKey }}'},
json={
'senderName': 'MailShipper',
'receiverEmail': 'client@example.com',
'subject': 'Bienvenue',
'body': '<h1>Bonjour!</h1>',
'senderEmail': 'contact@votre-domaine.com',
'password': 'votre_mot_de_passe',
'host': 'mail.votre-domaine.com'
}
)
print(response.json())
$response = curl_post(
'{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}',
[
'senderName' => 'MailShipper',
'receiverEmail' => 'client@example.com',
'subject' => 'Bienvenue',
'body' => '<h1>Bonjour!</h1>',
'senderEmail' => 'contact@votre-domaine.com',
'password' => 'votre_mot_de_passe',
'host' => 'mail.votre-domaine.com'
]
);
$result = json_decode($response, true);
print_r($result);
Réponses
Succès
{
"status": 200,
"message": "sent",
"data": {
"accepted": ["client@example.com"],
"rejected": [],
"messageId": "<uuid@domaine.com>",
"response": "250 OK id=..."
}
}
API key invalide
{
"success": false,
"error": "API key invalide ou expirée"
}
Domaine non autorisé
{
"success": false,
"error": "Domaine exemple.com n'est pas autorisé. Domaines autorisés: votre-domaine.com"
}
Bonnes Pratiques
Vérifiez votre configuration SMTP
Assurez-vous que host, senderEmail et password sont corrects.
Domaine autorisé requis
Vérifiez votre dashboard pour voir les domaines inclus dans votre plan.
Sécurisez vos emails
Utilisez des mots de passe forts et activez l'authentification 2FA.
Envois illimités
Envoyez autant d'emails que vous voulez, aucune limite de volume.
Obtenir vos identifiants SMTP
Pour utiliser l'API, vous avez besoin de 3 informations SMTP :
- Host : le serveur SMTP (ex: mail.votre-domaine.com)
- Password : le mot de passe de votre compte email
- Sender Email : votre adresse email complète
Guides par hébergeur
Namecheap
Email hosting cPanel
Créez un email via cPanel et récupérez vos identifiants SMTP.
Voir le guideGoDaddy
Workspace Email
Configurez votre email professionnel et obtenez les accès SMTP.
Voir le guideOVH / Hostinger
Hébergement web
Créez un compte email depuis votre panel d'hébergement.
Voir le guideGoogle Workspace
Gmail professionnel
Utilisez Gmail avec le mot de passe d'application pour SMTP.
Voir le guideAutre fournisseur ?
Guide généraliste
Vous ne trouvez pas votre hébergeur ? Consultez notre guide général pour comprendre comment récupérer vos identifiants SMTP.
Voir le guide généralConfiguration SMTP typique
| Host | mail.votre-domaine.com |
| Port | 587 (TLS) ou 465 (SSL) |
| Username | contact@votre-domaine.com |
| Password | Votre mot de passe email |
Prêt à envoyer des emails ?
Créez votre compte et commencez à utiliser l'API maintenant
Commencer maintenant