Receber e-mails: Rotas

Raw Message

Baixe o .eml bruto de uma mensagem ou de um dos anexos dela como dados binários.

GEThttps://g.sendcorex.com/v1/raw
i

Os ids de mensagem são base64, então contêm +, / e =. Faça o URL-encode deles. As bibliotecas HTTP fazem isso por você quando você os passa como query parameters, como nos exemplos abaixo.

!

Anexos são sempre servidos como attachment com application/octet-stream. O tipo original vem no header de resposta X-Original-Content-Type. Trate anexos como arquivos não confiáveis.

Query parameters

  • message_idstringobrigatório

    O message_uid da mensagem.

  • attachment_idstringopcional

    O attachment_id retornado por get_messages. Quando informado, o anexo é retornado em vez do e-mail inteiro.

Início rápido

import axios from 'axios';
import { writeFileSync } from 'node:fs';

const response = await axios.get('https://g.sendcorex.com/v1/raw', {
  params: { message_id: 'Vj0xQUJDMTIz', attachment_id: 'Vj0xQVRUMDE' },
  headers: { Authorization: process.env.SENDCOREX_TOKEN },
  responseType: 'arraybuffer',
});

writeFileSync('attachment.bin', Buffer.from(response.data));

Resposta

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment
X-Original-Content-Type: application/pdf

<binary data>

Campos da resposta

  • Content-Type

    message/rfc822 para o e-mail bruto, ou application/octet-stream para um anexo.

  • X-Original-Content-Type

    O tipo MIME real do anexo, como application/pdf.

Baixar o e-mail inteiro

Deixe attachment_id de fora para receber a mensagem original como um arquivo .eml.

Node.js

import axios from 'axios';
import { writeFileSync } from 'node:fs';

const res = await axios.get('https://g.sendcorex.com/v1/raw', {
  params: { message_id: 'Vj0xQUJDMTIz' },
  headers: { Authorization: process.env.SENDCOREX_TOKEN },
  responseType: 'arraybuffer',
});

writeFileSync('message.eml', Buffer.from(res.data));

Erros

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

  • 401MISSING_AUTH_HEADER

    Nenhum header Authorization foi enviado.

  • 401INVALID_TOKEN

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

  • 401TOKEN_EXPIRED

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

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