Recibir correos: Rutas
Raw Message
Descarga el .eml en bruto de un mensaje o de uno de sus adjuntos como datos binarios.
https://g.sendcorex.com/v1/rawLos 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_idstringobligatorioEl
message_uiddel mensaje.attachment_idstringopcionalEl
attachment_iddevuelto porget_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-Typemessage/rfc822para el correo en bruto, oapplication/octet-streampara un adjunto.X-Original-Content-TypeEl 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.
- 401
MISSING_AUTH_HEADERNo se envió ningún header Authorization.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.