Receber e-mails: Rotas
Raw Message
Baixe o .eml bruto de uma mensagem ou de um dos anexos dela como dados binários.
https://g.sendcorex.com/v1/rawOs 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órioO
message_uidda mensagem.attachment_idstringopcionalO
attachment_idretornado porget_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-Typemessage/rfc822para o e-mail bruto, ouapplication/octet-streampara um anexo.X-Original-Content-TypeO 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.
- 401
MISSING_AUTH_HEADERNenhum header Authorization foi enviado.
- 401
INVALID_TOKENO token está malformado, é desconhecido ou foi revogado.
- 401
TOKEN_EXPIREDO access token expirou. Chame Refresh Token e repita a requisição.
- 429
RATE_LIMITEDMais 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.