Recibir correos: Adjuntos
Subir archivo grande
Sube un archivo de hasta 25 MB como datos binarios, fuera del JSON de 1 MB de POST /v1. Devuelve el mismo compose_uid e id de adjunto que upload_attachment.
https://g.sendcorex.com/v1/attachmentUsa esta ruta para archivos de más de unos 700 KB. En upload_attachment el archivo va en base64 dentro del JSON, que está limitado a 1 MB, y base64 hace el archivo un 33% más grande.
Después envía el compose_uid (y, opcionalmente, attachment_ids) en send_email, reply, forward, schedule_send o save_draft. Vuelve a enviar el mismo compose_uid para añadir más archivos al mismo correo.
Los archivos subidos que no se envían en 48 horas, y que no usa ningún borrador o correo programado, se eliminan. Vuelve a subir el archivo si recibes ATTACHMENT_MISSING.
Query parameters
file_namestringobligatorioNombre del archivo que ve el destinatario. Obligatorio con body binario; con multipart se usa el nombre de la parte
file.compose_uidstringopcionalAñade el archivo a un correo que ya estás preparando. Con multipart también puede ser un campo del formulario.
Inicio rápido
import axios from 'axios';
import { readFileSync } from 'node:fs';
const res = await axios.post('https://g.sendcorex.com/v1/attachment', readFileSync('invoice.pdf'), {
params: { file_name: 'invoice.pdf' },
headers: {
Authorization: process.env.SENDCOREX_TOKEN,
'Content-Type': 'application/pdf',
},
maxBodyLength: Infinity,
});
const { compose_uid, attachment } = res.data.data;
console.log(compose_uid, attachment.id);Respuesta
{
"type": "SUCCESS",
"data": {
"compose_uid": "Vj0xQ01QMDAx",
"attachment": {
"id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
"file_name": "invoice.pdf",
"size_bytes": 3145728,
"content_type": "application/pdf"
}
}
}Campos de la respuesta
data.compose_uidEnvíalo con las siguientes subidas del mismo correo y con el comando de envío.
data.attachment.idÚsalo en
attachment_idsodelete_attachment.
Body de la solicitud
Envía el archivo de una de dos formas. Un archivo por solicitud.
BinarioEl body es el propio archivo. Pon en
Content-Typeel tipo del archivo (por ejemploapplication/pdf); sin él, el archivo se guarda comoapplication/octet-stream.Multipartmultipart/form-datacon el archivo en el campofile. Campos opcionales:compose_uidyfile_name.
Límites
Por archivo25 MB.
Por correo20 archivos y 25 MB en total.
Por buzón50 correos con archivos subidos aún no enviados, y 500 MB en total. Enviar un correo libera su parte al instante.
Archivos subidos sin usarSe eliminan tras 48 horas si ningún borrador o correo programado los usa. Los archivos de un borrador o correo programado se mantienen mientras exista.
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.
- 400
INVALID_ARGSFalta `file_name` (body binario), el multipart no tiene campo `file` o tiene más de uno, o `compose_uid` no es válido.
- 400
INVALID_ATTACHMENTEl archivo está vacío o no se pudo leer.
- 400
FILE_BLOCKEDEl análisis de seguridad bloqueó el archivo.
- 400
ALREADY_SENTEl `compose_uid` pertenece a un correo que ya se envió.
- 400
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.
- 413
ATTACHMENTS_TOO_LARGEEl archivo supera 25 MB, el correo supera 25 MB, o el buzón ya tiene 500 MB de archivos subidos esperando a enviarse.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.