Skip to content

Exemples de code ​

Exemples d'envoi via Mailiqo depuis les langages et frameworks les plus courants, en SMTP ou avec l'API.

Versions vérifiées le 2 novembre 2026

Nodemailer 10.3.1, PHPMailer 7.1.1, Laravel 13 (valable aussi pour 11 et 12), Symfony 8.1 et la bibliothèque standard de Python 3. D'après la documentation officielle de chaque projet (liens à la fin).

Avant de commencer ​

  • SMTP : hôte smtpmq.mailiqo.com, port 587 avec STARTTLS (ou 465 avec TLS implicite), et le nom d'utilisateur et le mot de passe SMTP du domaine, depuis Email → Domaines.
  • API : une clé API depuis Paramètres → API et intégrations, envoyée dans l'en-tête X-API-KEY. Voir Authentification.
  • L'expéditeur doit être une adresse du domaine vérifié.
  • Gardez les identifiants hors du code. Les exemples les lisent depuis les variables d'environnement MAILIQO_SMTP_USER, MAILIQO_SMTP_PASS et MAILIQO_API_KEY.

SMTP est la façon la plus rapide de connecter une application qui envoie déjà des emails. L'API renvoie le résultat par destinataire et un uuid pour suivre la livraison. Voir Vue d'ensemble SMTP et API d'envoi d'emails.

SMTP ​

Node.js (Nodemailer) ​

bash
npm install nodemailer
js
import nodemailer from 'nodemailer';

const transporter = nodemailer.createTransport({
  host: 'smtpmq.mailiqo.com',
  port: 587,
  secure: false,
  requireTLS: true,
  auth: {
    user: process.env.MAILIQO_SMTP_USER,
    pass: process.env.MAILIQO_SMTP_PASS,
  },
});

const info = await transporter.sendMail({
  from: '"Votre boutique" <[email protected]>',
  to: '[email protected]',
  subject: 'Votre commande a été expédiée',
  text: 'Votre commande est en route.',
  html: '<p>Votre commande est en route.</p>',
});

console.log(info.messageId);

secure: false avec requireTLS: true fait que Nodemailer passe la connexion en STARTTLS et échoue s'il n'y parvient pas. Pour le port 465, utilisez port: 465 et secure: true.

PHP (PHPMailer) ​

bash
composer require phpmailer/phpmailer
php
<?php

use PHPMailer\PHPMailer\Exception;
use PHPMailer\PHPMailer\PHPMailer;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);

try {
    $mail->isSMTP();
    $mail->Host = 'smtpmq.mailiqo.com';
    $mail->Port = 587;
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->SMTPAuth = true;
    $mail->Username = getenv('MAILIQO_SMTP_USER');
    $mail->Password = getenv('MAILIQO_SMTP_PASS');
    $mail->CharSet = PHPMailer::CHARSET_UTF8;

    $mail->setFrom('[email protected]', 'Votre boutique');
    $mail->addAddress('[email protected]');
    $mail->isHTML(true);
    $mail->Subject = 'Votre commande a été expédiée';
    $mail->Body = '<p>Votre commande est en route.</p>';
    $mail->AltBody = 'Votre commande est en route.';

    $mail->send();
} catch (Exception $e) {
    echo $mail->ErrorInfo;
}

Pour le port 465, utilisez $mail->Port = 465 et PHPMailer::ENCRYPTION_SMTPS.

Laravel ​

Dans .env :

ini
MAIL_MAILER=smtp
MAIL_SCHEME=smtp
MAIL_HOST=smtpmq.mailiqo.com
MAIL_PORT=587
MAIL_USERNAME=votre-identifiant-smtp
MAIL_PASSWORD=votre-mot-de-passe-smtp
MAIL_FROM_ADDRESS[email protected]
MAIL_FROM_NAME="Votre boutique"

Avec MAIL_SCHEME=smtp et le port 587, Laravel passe la connexion en STARTTLS. Pour le port 465, utilisez MAIL_PORT=465 et MAIL_SCHEME=smtps. Sous Laravel 10, utilisez MAIL_ENCRYPTION=tls à la place de MAIL_SCHEME.

php
use Illuminate\Support\Facades\Mail;

Mail::raw('Votre commande est en route.', function ($message) {
    $message->to('[email protected]')->subject('Votre commande a été expédiée');
});

Dans une vraie application, vous enverriez normalement un Mailable ; la configuration SMTP est la même. Si la configuration est mise en cache, lancez php artisan config:cache après avoir modifié .env.

Symfony Mailer ​

bash
composer require symfony/mailer

Dans .env.local :

ini
MAILER_DSN=smtp://USERNAME:[email protected]:587?require_tls=true

Si le nom d'utilisateur ou le mot de passe contiennent des caractères spéciaux, encodez-les en URL. Pour le port 465, utilisez smtps://USERNAME:[email protected]:465.

php
use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;

final class OrderMailer
{
    public function __construct(private MailerInterface $mailer)
    {
    }

    public function sendShipped(string $to): void
    {
        $email = (new Email())
            ->from('[email protected]')
            ->to($to)
            ->subject('Votre commande a été expédiée')
            ->text('Votre commande est en route.')
            ->html('<p>Votre commande est en route.</p>');

        $this->mailer->send($email);
    }
}

Si votre application utilise Messenger, Symfony met l'email en file par défaut et le worker l'envoie, les erreurs SMTP apparaissent donc dans le worker.

Python (smtplib) ​

python
import os
import smtplib
import ssl
from email.message import EmailMessage

msg = EmailMessage()
msg['From'] = 'Votre boutique <[email protected]>'
msg['To'] = '[email protected]'
msg['Subject'] = 'Votre commande a été expédiée'
msg.set_content('Votre commande est en route.')
msg.add_alternative('<p>Votre commande est en route.</p>', subtype='html')

context = ssl.create_default_context()
with smtplib.SMTP('smtpmq.mailiqo.com', 587, timeout=30) as server:
    server.starttls(context=context)
    server.login(os.environ['MAILIQO_SMTP_USER'], os.environ['MAILIQO_SMTP_PASS'])
    server.send_message(msg)

Pour le port 465, utilisez smtplib.SMTP_SSL('smtpmq.mailiqo.com', 465, context=context) et retirez l'appel à starttls().

API ​

POST https://api.mailiqo.com/v1/mailing/send avec l'email en JSON. Tous les champs sont décrits dans POST /mailing/send.

bash
curl -X POST https://api.mailiqo.com/v1/mailing/send \
  -H "X-API-KEY: $MAILIQO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Votre commande a été expédiée",
    "body_html": "<p>Votre commande est en route.</p>",
    "body_txt": "Votre commande est en route."
  }'
js
const response = await fetch('https://api.mailiqo.com/v1/mailing/send', {
  method: 'POST',
  headers: {
    'X-API-KEY': process.env.MAILIQO_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: '[email protected]',
    to: '[email protected]',
    subject: 'Votre commande a été expédiée',
    body_html: '<p>Votre commande est en route.</p>',
    body_txt: 'Votre commande est en route.',
  }),
});

const result = await response.json();
console.log(response.status, result.status);
php
<?php

$payload = [
    'from' => '[email protected]',
    'to' => '[email protected]',
    'subject' => 'Votre commande a été expédiée',
    'body_html' => '<p>Votre commande est en route.</p>',
    'body_txt' => 'Votre commande est en route.',
];

$ch = curl_init('https://api.mailiqo.com/v1/mailing/send');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: ' . getenv('MAILIQO_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$result = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
php
// config/services.php: 'mailiqo' => ['key' => env('MAILIQO_API_KEY')],

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'X-API-KEY' => config('services.mailiqo.key'),
])->post('https://api.mailiqo.com/v1/mailing/send', [
    'from' => '[email protected]',
    'to' => '[email protected]',
    'subject' => 'Votre commande a été expédiée',
    'body_html' => '<p>Votre commande est en route.</p>',
    'body_txt' => 'Votre commande est en route.',
]);

$result = $response->json();
php
use Symfony\Component\DependencyInjection\Attribute\Autowire;
use Symfony\Contracts\HttpClient\HttpClientInterface;

final class MailiqoClient
{
    public function __construct(
        private HttpClientInterface $httpClient,
        #[Autowire(env: 'MAILIQO_API_KEY')] private string $apiKey,
    ) {
    }

    public function send(array $email): array
    {
        $response = $this->httpClient->request('POST', 'https://api.mailiqo.com/v1/mailing/send', [
            'headers' => ['X-API-KEY' => $this->apiKey],
            'json' => $email,
        ]);

        return $response->toArray(false);
    }
}
python
import os
import requests

response = requests.post(
    'https://api.mailiqo.com/v1/mailing/send',
    headers={'X-API-KEY': os.environ['MAILIQO_API_KEY']},
    json={
        'from': '[email protected]',
        'to': '[email protected]',
        'subject': 'Votre commande a été expédiée',
        'body_html': '<p>Votre commande est en route.</p>',
        'body_txt': 'Votre commande est en route.',
    },
    timeout=30,
)

result = response.json()

Un 200 signifie que l'email a été mis en file : vérifiez status et, s'il vaut warning, la liste rejected_recipients. Voir API d'envoi d'emails.

Erreurs et limites d'envoi ​

API ​

HTTPQue faire
200Mis en file. Avec status = warning, certains destinataires ont été rejetés : vérifiez rejected_recipients.
400Corrigez la requête : error.code en donne la raison. Voir Erreurs.
401Vérifiez la clé API.
429Limite d'envoi atteinte (code 1421). Attendez le nombre de secondes indiqué dans l'en-tête Retry-After et renvoyez.
500Réessayez plus tard.

Une requête rejetée avec 429 n'est pas mise en file : votre application doit la renvoyer une fois le délai Retry-After écoulé. Voir Limites d'envoi.

SMTP ​

Les réponses commençant par 4 sont temporaires, comme 451 4.7.1 quand la limite d'envoi est atteinte : le serveur n'a pas accepté le message, renvoyez-le donc plus tard. Les réponses commençant par 5 sont permanentes : renvoyer le même message échoue tant que vous ne corrigez pas la cause. Voir Erreurs SMTP.

Où chaque bibliothèque vous donne la réponse du serveur :

BibliothèqueOù
Nodemailererr.responseCode et err.response
PHPMailer$mail->ErrorInfo
Laravel et Symfony MailerLe message de la TransportException
Pythonsmtp_code et smtp_error de smtplib.SMTPResponseException et ses sous-classes

Sources ​

Vérifiées le 2 novembre 2026 :


Étapes suivantes ​

Built with VitePress