Enviar adjuntos
Adjunta archivos a cualquier email incluyendo el array attachments en el payload de envío. Los archivos deben estar codificados en base64 y puedes incluir varios adjuntos en una sola llamada.
https://mail.sendcorex.com/v3.0/send Los adjuntos usan el mismo endpoint que Enviar email. Añade el array attachments junto a los demás parámetros del body.
Parámetros del adjunto
Cada elemento del array attachments es un objeto con los campos siguientes.
filenamestringobligatorioEl nombre de archivo que ve el destinatario en su cliente de email.
p. ej.
"invoice.pdf"contentstringobligatorioEl contenido del archivo codificado como string base64.
p. ej.
"JVBERi0xLjQKJeLjz9MK..."encodingstringobligatorioLa codificación de content. Debe ser "base64".
p. ej.
"base64"
Inicio rápido
import axios from 'axios';
import fs from 'fs';
const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');
try {
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Your Invoice #1042',
body: '<p>Please find your invoice attached.</p>',
attachments: [
{
filename: 'invoice.pdf',
content: fileContent,
encoding: 'base64',
},
],
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id, ids, recipients } = response.data;
console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
// Attachment blocked for security reasons. There is no quarantine record.
console.log('Blocked:', err.response.data.riskLevel);
} else {
throw err;
}
}Respuesta
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"recipients": 1,
"scheduledAt": null
}Mi adjunto fue bloqueado
Para proteger nuestra plataforma y la reputación de envío de todos los clientes, los adjuntos se revisan antes de encolar un email. Cuando un archivo se considera inseguro, la solicitud devuelve 400 con el código DANGEROUS_ATTACHMENT y el email no se envía.
Adjunto bloqueado
{
"error": "One or more attachments were blocked for security reasons.",
"code": "DANGEROUS_ATTACHMENT",
"riskLevel": "high"
}errorUn mensaje legible que explica que se bloqueó un adjunto.
codeSiempre DANGEROUS_ATTACHMENT en esta respuesta.
riskLevelEl nivel de riesgo asignado al adjunto bloqueado. Inclúyelo al contactar con soporte.
No hay registro de cuarentena para este error.A diferencia de los emails marcados como spam, un adjunto bloqueado no se puede liberar con /quarantine/release. Es una protección deliberada contra spammers y remitentes abusivos, por lo que el email nunca queda retenido para entregarse más tarde.
¿Qué debo hacer?
Las comprobaciones automáticas pueden marcar ocasionalmente un archivo legítimo. Si necesitas enviar este adjunto, contacta con nuestro equipo de soporte. Nuestro equipo conoce este comportamiento y, cuando un bloqueo resulta ser un falso positivo, lo revisamos y aplicamos las actualizaciones necesarias.
Para ayudarnos a resolverlo más rápido, incluye:
- El nombre y el tipo de archivo del adjunto
- El riskLevel devuelto por la API
- Para qué se usa el archivo en tu producto
Errores
Todos los códigos de error →Los errores devuelven un objeto JSON con error y code.
- 401
MISSING_AUTH_HEADERNo hay header Authorization.
- 401
INVALID_API_KEYLa API key no es válida o fue revocada.
- 401
ACCOUNT_BLOCKEDLa cuenta fue bloqueada.
- 401
NO_CREDITS_LEFTNo hay créditos de email suficientes para todos los destinatarios. Cada dirección en to, cc y bcc usa 1 crédito.
- 401
DOMAIN_NOT_VALIDATEDDominio del remitente no verificado.
- 401
LISTED_SPAM_HAUSEl dominio del remitente está listado en Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDNo se permite enviar desde dominios conocidos (gmail.com, outlook.com, etc).
- 401
FROM_HEADER_DOMAIN_MISMATCHDominio del header From no autorizado para este remitente.
- 401
USER_NOT_FOUNDUsuario no encontrado.
- 401
MISSING_USER_PRIVILEGESFaltan privilegios de usuario.
- 401
EMAIL_CREDITS_NOT_FOUNDError al obtener los créditos de email.
- 401
EMAIL_NOT_VALIDATEDEl email de la cuenta aún no fue verificado.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key bloqueada temporalmente por violaciones repetidas de la política.
- 429
IP_TEMPORARILY_BLOCKEDIP de la solicitud bloqueada temporalmente por violaciones repetidas de la política.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSDemasiadas solicitudes simultáneas desde esta IP. Inténtalo de nuevo en breve.
- 400
INVALID_JSONEl cuerpo de la solicitud no es un JSON válido.
- 400
MISSING_FROMEl campo from falta o está vacío.
- 400
INVALID_FROM_FORMATEl campo from debe ser una dirección de email válida.
- 400
MISSING_SENDERNAMEEl campo senderName falta o está vacío.
- 400
INVALID_SENDERNAME_FORMATEl campo senderName contiene caracteres no válidos.
- 400
MISSING_SUBJECTEl campo subject falta o está vacío.
- 400
MISSING_BODYEl campo body falta o está vacío.
- 400
MISSING_TOADDRESSEl campo to falta o está vacío.
- 400
MISSING_TOEl campo to falta o está vacío.
- 400
INVALID_TOADDRESSUna o más direcciones de destinatario están mal formadas.
- 400
TOADDRESS_LIMIT_EXCEEDEDMás de 50 destinatarios en el array to.
- 400
INVALID_CCADDRESSUna o más direcciones de cc están mal formadas.
- 400
INVALID_BCCADDRESSUna o más direcciones de bcc están mal formadas.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc y bcc juntos tienen más de 50 destinatarios únicos.
- 400
INVALID_SCHEDULED_ATscheduled_at no es una fecha válida o está en el pasado.
- 400
INVALID_SENDER_FORMATEl formato del email del remitente no es válido.
- 400
HEADER_NOT_ALLOWEDLa clave del header personalizado no está en la lista permitida (List-Unsubscribe, List-Id, X-*, etc).
- 400
INVALID_HEADER_VALUEEl valor del header contiene caracteres no válidos (CR/LF no permitidos).
- 400
DANGEROUS_ATTACHMENTUno o más adjuntos fueron bloqueados por motivos de seguridad.
- 400
INVALID_ATTACHMENTEl contenido de un adjunto no es base64 válido.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe es true pero el body no tiene placeholder de baja ([unsubscribe_url], [unsubscribe], [unsub_url] o [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDLa cuenta está restringida temporalmente.
- 403
DAILY_LIMITSe alcanzó el límite diario de envío de emails.
- 403
MARKETING_LIMIT_REACHEDSe alcanzó el límite diario de marketing del plan gratuito: 30 emails de marketing o cold outreach por día, contados por destinatario en una ventana móvil de 24 horas. La respuesta incluye limit, used, recipients y upgradeUrl. Los emails transaccionales se siguen enviando; nada queda en cola.
- 403
FORBIDDEN_HTML_CONTENTEl HTML contiene contenido activo no permitido en emails (script, iframe, form, input, button, embed, object, svg, handlers on*, enlaces javascript:, meta refresh…). La respuesta lista lo encontrado. Usa un <a> con estilos en lugar de botones o formularios.
- 403
SPAM_DETECTEDContenido del email marcado como spam. La respuesta incluye el quarantine_id y las instrucciones de liberación.
- 403
SENDER_NAME_MISMATCHSe detectaron varios nombres de remitente para la misma dirección.
- 403
FOLLOWUP_PATTERN_DETECTEDContenido del email marcado como patrón repetido de seguimiento sospechoso.
- 403
SCAM_PATTERN_DETECTEDContenido del email marcado como patrón de estafa.
- 403
ACCOUNT_SUSPENDED_SPOOFINGCuenta suspendida por intentos repetidos de suplantación del header From.
- 409
IDEMPOTENCY_IN_PROGRESSUna solicitud con la misma Idempotency-Key todavía se está procesando. Espera (Retry-After: 1) y reintenta con la misma clave.
- 422
IDEMPOTENCY_KEY_REUSEDEsta Idempotency-Key ya se usó con otro cuerpo. Usa una clave nueva para cada email nuevo.
- 500
INTERNAL_SERVER_ERRORError inesperado del servidor. Inténtalo de nuevo.
- 500
PARSE_ERRORNo se pudo procesar el contenido del email (fallo de parse MIME).
- 500
PERSIST_FAILEDNo se pudo poner el email en cola (fallo de persistencia en la base de datos).
- 503
AUTH_UNAVAILABLENo se pudo validar la API key en este momento. Inténtalo de nuevo.
- 503
UNSUBSCRIBE_UNAVAILABLEServicio de enlace de baja no disponible temporalmente. Inténtalo más tarde.