Recibir correos: Adjuntos
Subir adjunto
Sube un archivo antes de enviar. Usa el compose_uid devuelto en send_email, reply, forward o schedule_send.
https://g.sendcorex.com/v1command: upload_attachmentSin compose_uid se crea uno nuevo. Envíalo de vuelta con los siguientes archivos del mismo correo. Cada archivo se analiza antes de guardarse.
Para archivos puntuales también puedes saltarte este paso y enviarlos en línea en attachments del comando de envío.
Toda la solicitud está limitada a 1 MB, y base64 hace el archivo un 33% más grande, así que este comando admite archivos de hasta unos 700 KB. Para archivos más grandes (hasta 25 MB) usa Subir archivo grande, que recibe el archivo como datos binarios.
Límites: 20 archivos y 25 MB por correo; por buzón, 50 correos con archivos subidos aún no enviados y 500 MB en total. Los archivos subidos que no se envían en 48 horas, y que no usa un borrador o correo programado, se eliminan.
Argumentos
file_namestringobligatorioNombre del archivo que ve el destinatario.
contentstringobligatorioEl archivo en base64 (también se acepta una URL data:). La solicitud está limitada a 1 MB, así que unos 700 KB de archivo.
content_typestringopcionalTipo MIME. Por defecto
application/octet-stream.compose_uidstringopcionalAñade el archivo a un correo que ya estás preparando.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "upload_attachment",
args: {
file_name: "invoice.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "upload_attachment",
"id": "0",
"type": "SUCCESS",
"data": {
"compose_uid": "Vj0xQ01QMDAx",
"attachment": {
"id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
"file_name": "invoice.pdf",
"size_bytes": 48213,
"content_type": "application/pdf"
}
}
}
]
}Campos de la respuesta
compose_uidEnvíalo con las siguientes subidas y con el comando de envío.
attachment.idÚsalo en
attachment_idsodelete_attachment.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
INVALID_ATTACHMENTEl contenido de un adjunto no es base64 válido.
- CMD
ATTACHMENTS_TOO_LARGELos adjuntos del correo suman más de 25 MB, o el buzón ya tiene 500 MB de archivos subidos esperando a enviarse.
- CMD
TOO_MANY_OPEN_COMPOSESEl buzón tiene 50 correos con archivos subidos que aún no se enviaron. Envíalos, o espera a que los que no se usan se eliminen tras 48 horas.
- CMD
FILE_BLOCKEDEl análisis de seguridad bloqueó un archivo.
- CMD
ALREADY_SENTEl compose_uid pertenece a un correo que ya se envió.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.