E-Mails empfangen: Routen

Raw Message

Laden Sie die rohe .eml einer Nachricht oder einen ihrer Anhänge als Binärdaten herunter.

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

Nachrichten-IDs sind Base64 und enthalten daher +, / und =. URL-kodieren Sie sie. HTTP-Bibliotheken erledigen das für Sie, wenn Sie sie als Query-Parameter übergeben, wie in den Beispielen unten.

!

Anhänge werden immer als attachment mit application/octet-stream ausgeliefert. Der ursprüngliche Typ steht im Response-Header X-Original-Content-Type. Behandeln Sie Anhänge als nicht vertrauenswürdige Dateien.

Query-Parameter

  • message_idstringerforderlich

    Die message_uid der Nachricht.

  • attachment_idstringoptional

    Die von get_messages zurückgegebene attachment_id. Wenn gesetzt, wird der Anhang statt der gesamten E-Mail zurückgegeben.

Schnellstart

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

Antwort

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

<binary data>

Antwortfelder

  • Content-Type

    message/rfc822 für die rohe E-Mail oder application/octet-stream für einen Anhang.

  • X-Original-Content-Type

    Der tatsächliche MIME-Typ des Anhangs, etwa application/pdf.

Die gesamte E-Mail herunterladen

Lassen Sie attachment_id weg, um die Originalnachricht als .eml-Datei zu erhalten.

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

Fehler

Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.

  • 401MISSING_AUTH_HEADER

    Es wurde kein Authorization-Header gesendet.

  • 401INVALID_TOKEN

    Der Token ist fehlerhaft, unbekannt oder widerrufen.

  • 401TOKEN_EXPIRED

    Der Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.

  • 429RATE_LIMITED

    Mehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.