El tamaño en disco es solo una parte del mensaje generado. Las cabeceras MIME y la codificación base64 añaden sobrecarga, así que un archivo que cabe en el límite publicado de un proveedor puede hacer que el mensaje sea demasiado grande.
¿Qué hace que un adjunto sea más grande en tránsito?
La codificación Base64 añade aproximadamente un tercio al tamaño de un archivo binario antes de que se agreguen los saltos de línea y las cabeceras MIME. El correo transporta ese archivo codificado como una parte MIME, junto con el cuerpo y las cabeceras.
Por ejemplo, un archivo binario de 12 MB se convierte en aproximadamente 16 MB de base64 antes de saltos de línea, cabeceras y cuerpo. Toma eso como una estimación, no como un límite del proveedor.
¿Qué límite debo usar?
Usa el límite más pequeño entre tu servicio de envío, el proveedor del destinatario y la ruta entre ambos. Los proveedores publican límites diferentes y pueden cambiarlos. Enlaza al límite actual del proveedor en lugar de fijar un número universal en el código.
Si un archivo está cerca del límite, colócalo detrás de un enlace de descarga autenticado. El mensaje se mantiene pequeño. Puedes expirar o revocar el acceso de forma independiente al correo.
| Límite | Qué limita | Consecuencia de ejemplo |
|---|---|---|
| Tope por adjunto | Un archivo o campo de adjunto | El API rechaza ese elemento |
| Tope del mensaje completo | Cuerpo, cabeceras y adjuntos codificados | El remitente rechaza el mensaje generado |
| Transferencia por enlace en la nube | El servicio de descarga vinculado | El destinatario sigue una política de acceso separada |
La ayuda personal de Gmail describe un límite total de adjuntos de 25 MB. Los administradores de Workspace pueden establecer límites diferentes para cuentas de trabajo y educativas. Trata ambos como valores específicos del proveedor.
¿Cómo debe manejar archivos grandes un API?
Verifica el tamaño del mensaje codificado antes de enviarlo. Rechaza o reemplaza un adjunto sobredimensionado con un enlace de descarga claro. Indica al usuario qué archivo provocó la decisión. No reintentes un mensaje sobredimensionado sin cambios.
Mantén los nombres de adjuntos y los tipos de contenido precisos. El proveedor del destinatario puede rechazar un mensaje por el tamaño total, un tipo de archivo bloqueado o una política aplicada al enlace.
¿Cómo maneja los adjuntos Bird?
Establece el array attachments en tu solicitud POST /v1/email/messages. Consulta la guía de adjuntos para conocer el presupuesto actual de mensaje generado de Bird. Un envío HTTP sobredimensionado devuelve 413. Mantén el contenido bruto de los adjuntos bien por debajo del presupuesto documentado para que los cuerpos y el empaquetado MIME quepan.
En resumen
- El límite cubre el mensaje codificado, el cuerpo, las cabeceras y los adjuntos.
- Base64 añade aproximadamente un tercio al tamaño de un archivo binario.
- Verifica cada proveedor en la ruta de entrega.
- Un enlace de descarga evita fallos por tamaño de adjunto en archivos grandes.