Recibir correos: Rutas

Raw Message

Descarga el .eml en bruto de un mensaje o de uno de sus adjuntos como datos binarios.

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

Los ids de mensaje están en base64, así que contienen +, / y =. Codifícalos para URL. Las bibliotecas HTTP lo hacen por ti cuando los pasas como query parameters, como en los ejemplos de abajo.

!

Los adjuntos siempre se sirven como attachment con application/octet-stream. El tipo original está en el header de respuesta X-Original-Content-Type. Trata los adjuntos como archivos no confiables.

Query parameters

  • message_idstringobligatorio

    El message_uid del mensaje.

  • attachment_idstringopcional

    El attachment_id devuelto por get_messages. Si se indica, se devuelve el adjunto en lugar del correo completo.

Inicio 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));

Respuesta

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

<binary data>

Campos de la respuesta

  • Content-Type

    message/rfc822 para el correo en bruto, o application/octet-stream para un adjunto.

  • X-Original-Content-Type

    El tipo MIME real del adjunto, como application/pdf.

Descargar el correo completo

Omite attachment_id para obtener el mensaje original como archivo .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));

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.

  • 401MISSING_AUTH_HEADER

    No se envió ningún header Authorization.

  • 401INVALID_TOKEN

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

  • 401TOKEN_EXPIRED

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

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