Documentation - MailShipper

1 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.

2 Envoyer un Email

Endpoint

POST {{ apiUrl }}/proxy/email/send?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/send?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/send?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/send',
    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/send?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);

3 Réponses

Succès (200)

{
  "status": 200,
  "message": "sent",
  "data": {
    "accepted": ["client@example.com"],
    "rejected": [],
    "messageId": "<uuid@domaine.com>",
    "response": "250 OK id=..."
  }
}

Erreur API key invalide (401)

{
  "success": false,
  "error": "API key invalide ou expirée"
}

Erreur domaine non autorisé (403)

{
  "success": false,
  "error": "Domaine exemple.com n'est pas autorisé. Domaines autorisés: votre-domaine.com"
}

4 Plans et Tarifs

Plan	Domaines	Prix
{{ plan.name }}	{{ plan.domains }}	{{ formatPrice(plan.price) }}/mois

5 Bonnes Pratiques

Vérifiez votre configuration SMTP

Assurez-vous que host, senderEmail et password sont corrects.

Le domaine du senderEmail doit être autorisé

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 sur votre compte email.

Documentation API