Réponse courte : pour envoyer un e-mail avec une API REST en Node.js, faites une requête POST avec fetch (intégré à Node 18+) vers l'endpoint d'envoi du fournisseur, avec votre clé API dans l'en-tête Authorization et un corps JSON contenant from, to, subject et html. Aucun SDK nécessaire — voir l'Option 2 pour le code complet.
Il existe deux bonnes façons d'envoyer des e-mails depuis Node.js : en SMTP avec Nodemailer, ou avec un simple appel fetch à une API REST. Node.js 18 ou plus suffit dans les deux cas — il vous faudra aussi un compte Sendcorex et un domaine d'envoi vérifié (publiez les enregistrements SPF, DKIM et DMARC fournis par le tableau de bord avant tout vrai envoi).
Option 1 : Nodemailer (SMTP)
npm install nodemailer
import nodemailer from 'nodemailer';
const transporter = nodemailer.createTransport({
host: 'smtp.sendcorex.com',
port: 587,
secure: false, // STARTTLS on 587
auth: { user: process.env.SENDCOREX_API_KEY, pass: process.env.SENDCOREX_API_KEY },
});
const info = await transporter.sendMail({
from: '"Your App" <hello@yourdomain.com>',
to: 'customer@example.com',
subject: 'Welcome!',
text: 'You are in.',
html: '<h1>You are in.</h1>',
});
console.log('Sent:', info.messageId);
Option 2 : API REST avec fetch
Aucune dépendance, fonctionne dans les environnements serverless et edge où le SMTP sortant est souvent bloqué :
const response = await fetch('https://graph.sendcorex.com/v3.0/emails', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.SENDCOREX_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
to: 'customer@example.com',
from: 'hello@yourdomain.com',
subject: 'Welcome!',
html: '<h1>You are in.</h1>',
}),
});
if (!response.ok) throw new Error(`Send failed: ${response.status}`);
Erreurs et réessais
| Symptôme | Correction |
|---|---|
Invalid login | Clé API manquante ou erronée — vérifiez que la variable d'environnement est chargée et sans espace parasite. |
ETIMEDOUT | L'hébergeur bloque le port SMTP — essayez 587/465, ou passez à l'API REST. |
| Arrive en spam | Vérifiez SPF/DKIM dans un vrai en-tête Gmail, envoyez text et html, augmentez le volume progressivement. |
Les réponses 4xx signifient que la requête elle-même est incorrecte — ne réessayez pas. 429 et 5xx sont temporaires — réessayez avec un backoff exponentiel.