Receber e-mails: Anexos

Fazer upload de anexo

Envie um arquivo antes de mandar o e-mail. Use o compose_uid retornado em send_email, reply, forward ou schedule_send.

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

Sem compose_uid, um novo é criado. Envie-o de volta com os próximos arquivos do mesmo e-mail. Cada arquivo é verificado antes de ser salvo.

i

Para arquivos avulsos, você também pode pular esta etapa e enviá-los inline em attachments do comando de envio.

!

A requisição inteira é limitada a 1 MB, e o base64 deixa o arquivo cerca de 33% maior, então este comando comporta arquivos de até uns 700 KB. Para arquivos maiores (até 25 MB), use Upload de arquivo grande, que recebe o arquivo como dados binários.

i

Limites: 20 arquivos e 25 MB por e-mail; por caixa de correio, 50 e-mails com uploads ainda não enviados e 500 MB no total. Uploads não enviados em 48 horas, e não usados por um rascunho ou e-mail agendado, são excluídos.

Argumentos

  • file_namestringobrigatório

    Nome do arquivo exibido para o destinatário.

  • contentstringobrigatório

    O arquivo em base64 (uma URL data: também é aceita). A requisição é limitada a 1 MB, então cerca de 700 KB de arquivo.

  • content_typestringopcional

    Tipo MIME. O padrão é application/octet-stream.

  • compose_uidstringopcional

    Adiciona o arquivo a um e-mail que você já está montando.

Início 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);

Resposta

{
  "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 da resposta

  • compose_uid

    Envie-o com os próximos uploads e com o comando de envio.

  • attachment.id

    Use-o em attachment_ids ou delete_attachment.

Erros

Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.

  • 401TOKEN_EXPIRED

    O access token expirou. Chame Refresh Token e repita a requisição.

  • 401INVALID_TOKEN

    O token está malformado, é desconhecido ou foi revogado.

  • 429RATE_LIMITED

    Mais de 15 requisições/s ou 15 em andamento para o mesmo IP + caixa de correio. Espere o número de segundos indicado em Retry-After.

  • CMDINVALID_ARGS

    Um argumento obrigatório está ausente ou é inválido.

  • CMDINVALID_ATTACHMENT

    O conteúdo de um anexo não é base64 válido.

  • CMDATTACHMENTS_TOO_LARGE

    Os anexos do e-mail somam mais de 25 MB, ou a caixa de correio já tem 500 MB de uploads aguardando envio.

  • CMDTOO_MANY_OPEN_COMPOSES

    A caixa de correio tem 50 e-mails com uploads ainda não enviados. Envie-os ou espere os não usados serem excluídos após 48 horas.

  • CMDFILE_BLOCKED

    Um arquivo foi bloqueado pela verificação de segurança.

  • CMDALREADY_SENT

    O compose_uid pertence a um e-mail que já foi enviado.

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.