Envoyer des e-mails en lot
Envoyez le même e-mail à plusieurs destinataires en un seul appel API en passant un tableau dans le champ to. Jusqu'à 50 adresses par appel. Chaque destinataire reçoit un e-mail individuel et les adresses ne sont pas visibles entre elles.
https://mail.sendcorex.com/v3.0/sendLe champ recipients de la réponse confirme le nombre d'adresses acceptées. Les adresses invalides du tableau sont ignorées et signalées dans skipped.
Paramètres du body
tostring[]obligatoireTableau d'adresses e-mail des destinataires. 50 maximum par appel.
ex.
["alice@x.com", "bob@x.com", "carol@x.com"]
Tous les autres paramètres sont identiques à ceux de Envoyer un e-mail.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: [
'alice@example.com',
'bob@example.com',
'carol@example.com',
],
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Important update for all users',
body: '<p>Here is your update...</p>',
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id, ids, recipients, skipped } = response.data;
console.log('Sent to ' + recipients + ' recipients');
// Invalid addresses are skipped and reported in "skipped"
if (skipped) console.log('Skipped:', skipped);Réponse
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "a898cf59-4b4e-4547-ad60-c0f818dae7fd",
"ids": [
{ "id": "a898cf59-4b4e-4547-ad60-c0f818dae7fd", "recipient": "foo@x.com" },
{ "id": "76627061-ab16-4bba-bcfc-ca7ff92ac251", "recipient": "bar@x.com" }
],
"recipients": 2,
"scheduledAt": null
}Erreurs
Tous les codes d'erreur →Les erreurs renvoient un objet JSON avec error et code.
- 401
MISSING_AUTH_HEADERAucun en-tête Authorization n'est présent.
- 401
INVALID_API_KEYLa clé API est invalide ou révoquée.
- 401
ACCOUNT_BLOCKEDLe compte a été bloqué.
- 401
NO_CREDITS_LEFTCrédits e-mail insuffisants pour tous les destinataires. Chaque adresse dans to, cc et bcc utilise 1 crédit.
- 401
DOMAIN_NOT_VALIDATEDDomaine de l'expéditeur non vérifié.
- 401
LISTED_SPAM_HAUSLe domaine de l'expéditeur est listé sur Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDL'envoi depuis des domaines connus (gmail.com, outlook.com, etc.) n'est pas autorisé.
- 401
FROM_HEADER_DOMAIN_MISMATCHDomaine de l'en-tête From non autorisé pour cet expéditeur.
- 401
USER_NOT_FOUNDUtilisateur introuvable.
- 401
MISSING_USER_PRIVILEGESPrivilèges utilisateur manquants.
- 401
EMAIL_CREDITS_NOT_FOUNDErreur lors de la récupération des crédits e-mail.
- 401
EMAIL_NOT_VALIDATEDL'adresse e-mail du compte n'a pas encore été vérifiée.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDClé API temporairement bloquée après des violations répétées de la politique.
- 429
IP_TEMPORARILY_BLOCKEDIP de la requête temporairement bloquée après des violations répétées de la politique.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSTrop de requêtes simultanées depuis cette IP. Réessayez dans un instant.
- 400
INVALID_JSONLe corps de la requête n'est pas un JSON valide.
- 400
MISSING_FROMLe champ from est manquant ou vide.
- 400
INVALID_FROM_FORMATLe champ from doit être une adresse e-mail valide.
- 400
MISSING_SENDERNAMELe champ senderName est manquant ou vide.
- 400
INVALID_SENDERNAME_FORMATLe champ senderName contient des caractères invalides.
- 400
MISSING_SUBJECTLe champ subject est manquant ou vide.
- 400
MISSING_BODYLe champ body est manquant ou vide.
- 400
MISSING_TOADDRESSLe champ to est manquant ou vide.
- 400
MISSING_TOLe champ to est manquant ou vide.
- 400
INVALID_TOADDRESSUne ou plusieurs adresses de destinataire sont mal formées.
- 400
TOADDRESS_LIMIT_EXCEEDEDPlus de 50 destinataires dans le tableau to.
- 400
INVALID_CCADDRESSUne ou plusieurs adresses cc sont mal formées.
- 400
INVALID_BCCADDRESSUne ou plusieurs adresses bcc sont mal formées.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc et bcc réunis comptent plus de 50 destinataires uniques.
- 400
INVALID_SCHEDULED_ATscheduled_at n'est pas une date valide ou est dans le passé.
- 400
INVALID_SENDER_FORMATLe format de l'e-mail de l'expéditeur est invalide.
- 400
HEADER_NOT_ALLOWEDLa clé de l'en-tête personnalisé n'est pas dans la liste autorisée (List-Unsubscribe, List-Id, X-*, etc.).
- 400
INVALID_HEADER_VALUELa valeur de l'en-tête contient des caractères invalides (CR/LF interdits).
- 400
DANGEROUS_ATTACHMENTUne ou plusieurs pièces jointes ont été bloquées pour des raisons de sécurité.
- 400
INVALID_ATTACHMENTLe contenu d'une pièce jointe n'est pas un base64 valide.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe vaut true mais le body ne contient aucun placeholder de désinscription ([unsubscribe_url], [unsubscribe], [unsub_url] ou [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDLe compte est temporairement restreint.
- 403
DAILY_LIMITLimite quotidienne d'envoi d'e-mails atteinte.
- 403
MARKETING_LIMIT_REACHEDLimite quotidienne marketing du plan gratuit atteinte : 30 e-mails marketing ou de prospection à froid par jour, comptés par destinataire sur une fenêtre glissante de 24 heures. La réponse contient limit, used, recipients et upgradeUrl. Les e-mails transactionnels partent toujours ; rien n'est mis en file d'attente.
- 403
FORBIDDEN_HTML_CONTENTLe HTML contient du contenu actif interdit dans les e-mails (script, iframe, form, input, button, embed, object, svg, handlers on*, liens javascript:, meta refresh…). La réponse liste les éléments détectés. Utilisez un <a> stylé au lieu de boutons ou de formulaires.
- 403
SPAM_DETECTEDContenu de l'e-mail signalé comme spam. La réponse inclut le quarantine_id et les instructions de libération.
- 403
SENDER_NAME_MISMATCHPlusieurs noms d'expéditeur détectés pour la même adresse.
- 403
FOLLOWUP_PATTERN_DETECTEDContenu de l'e-mail signalé comme schéma répété de relance suspecte.
- 403
SCAM_PATTERN_DETECTEDContenu de l'e-mail signalé comme schéma d'arnaque.
- 403
ACCOUNT_SUSPENDED_SPOOFINGCompte suspendu après des tentatives répétées d'usurpation de l'en-tête From.
- 409
IDEMPOTENCY_IN_PROGRESSUne requête avec la même Idempotency-Key est encore en cours de traitement. Attendez (Retry-After: 1) et réessayez avec la même clé.
- 422
IDEMPOTENCY_KEY_REUSEDCette Idempotency-Key a déjà été utilisée avec un autre corps. Utilisez une nouvelle clé pour chaque nouvel e-mail.
- 500
INTERNAL_SERVER_ERRORErreur serveur inattendue. Réessayez.
- 500
PARSE_ERRORÉchec du traitement du contenu de l'e-mail (échec du parsing MIME).
- 500
PERSIST_FAILEDÉchec de la mise en file de l'e-mail (échec d'écriture en base de données).
- 503
AUTH_UNAVAILABLEImpossible de valider la clé API pour le moment. Réessayez.
- 503
UNSUBSCRIBE_UNAVAILABLEService de lien de désinscription temporairement indisponible. Réessayez plus tard.