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.

POSThttps://g.sendcorex.com/v1/attachment
i

Usa 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.

i

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_namestringobligatorio

    Nombre del archivo que ve el destinatario. Obligatorio con body binario; con multipart se usa el nombre de la parte file.

  • compose_uidstringopcional

    Añ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_uid

    Envíalo con las siguientes subidas del mismo correo y con el comando de envío.

  • data.attachment.id

    Úsalo en attachment_ids o delete_attachment.

Body de la solicitud

Envía el archivo de una de dos formas. Un archivo por solicitud.

  • Binario

    El body es el propio archivo. Pon en Content-Type el tipo del archivo (por ejemplo application/pdf); sin él, el archivo se guarda como application/octet-stream.

  • Multipart

    multipart/form-data con el archivo en el campo file. Campos opcionales: compose_uid y file_name.

Límites

  • Por archivo

    25 MB.

  • Por correo

    20 archivos y 25 MB en total.

  • Por buzón

    50 correos con archivos subidos aún no enviados, y 500 MB en total. Enviar un correo libera su parte al instante.

  • Archivos subidos sin usar

    Se 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.

  • 401TOKEN_EXPIRED

    El access token expiró. Llama a Refresh Token y repite la solicitud.

  • 401INVALID_TOKEN

    El token está mal formado, es desconocido o fue revocado.

  • 429RATE_LIMITED

    Más de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.

  • 400INVALID_ARGS

    Falta `file_name` (body binario), el multipart no tiene campo `file` o tiene más de uno, o `compose_uid` no es válido.

  • 400INVALID_ATTACHMENT

    El archivo está vacío o no se pudo leer.

  • 400FILE_BLOCKED

    El análisis de seguridad bloqueó el archivo.

  • 400ALREADY_SENT

    El `compose_uid` pertenece a un correo que ya se envió.

  • 400TOO_MANY_OPEN_COMPOSES

    El 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.

  • 413ATTACHMENTS_TOO_LARGE

    El archivo supera 25 MB, el correo supera 25 MB, o el buzón ya tiene 500 MB de archivos subidos esperando a enviarse.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.