Recibir correos: Adjuntos

Subir adjunto

Sube un archivo antes de enviar. Usa el compose_uid devuelto en send_email, reply, forward o schedule_send.

POSThttps://g.sendcorex.com/v1command: upload_attachment
i

Sin compose_uid se crea uno nuevo. Envíalo de vuelta con los siguientes archivos del mismo correo. Cada archivo se analiza antes de guardarse.

i

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.

i

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_namestringobligatorio

    Nombre del archivo que ve el destinatario.

  • contentstringobligatorio

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

    Tipo MIME. Por defecto application/octet-stream.

  • compose_uidstringopcional

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

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

  • attachment.id

    Úsalo en attachment_ids o delete_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.

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

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDINVALID_ATTACHMENT

    El contenido de un adjunto no es base64 válido.

  • CMDATTACHMENTS_TOO_LARGE

    Los adjuntos del correo suman más de 25 MB, o el buzón ya tiene 500 MB de archivos subidos esperando a enviarse.

  • CMDTOO_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.

  • CMDFILE_BLOCKED

    El análisis de seguridad bloqueó un archivo.

  • CMDALREADY_SENT

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

  • CMDINTERNAL

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