E-Mails empfangen: Lesen

Nachrichten abrufen

Lesen Sie bis zu 50 Nachrichten per ID, mit Inhalt, Anhangliste und Headern.

POSThttps://g.sendcorex.com/v1command: get_messages
!

Der HTML-Inhalt wird roh und unbereinigt zurückgegeben. Bereinigen Sie ihn in Ihrem Client, bevor Sie ihn rendern.

Argumente

  • idsstring[]optional

    Bis zu 50 Nachrichten-IDs.

  • idstringoptional

    Eine einzelne Nachrichten-ID. Verwenden Sie diese oder ids.

  • includestring[]optional

    Was jeder Nachricht hinzugefügt werden soll: body, attachments, headers, full_headers. Standard ist ["body","attachments"].

    z. B. ["body", "headers", "attachments"]

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "get_messages",
        args: {
          ids: [
            "Vj0xQUJDMTIz"
          ],
          include: [
            "body",
            "headers",
            "attachments"
          ]
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Antwort

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "get_messages",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "messages": [
          {
            "message_uid": "Vj0xQUJDMTIz",
            "thread_id": "thr_9a1c4e72",
            "message_id": "<3f2a1b4c@SCOREX123MB45.prd.sendcorex.com>",
            "folders": [
              "INBOX"
            ],
            "labels": [
              "cliente-vip"
            ],
            "from_name": "Ana Costa",
            "from_email": "ana@client.com",
            "to": [
              {
                "email": "you@yourdomain.com"
              }
            ],
            "cc": [],
            "bcc": [],
            "subject": "Invoice for September",
            "is_read": false,
            "is_starred": false,
            "is_important": false,
            "snoozed_until": null,
            "received_at": "2026-10-09T14:21:07Z",
            "body": {
              "html": "<p>Hi, attached is the invoice.</p>",
              "text": "Hi, attached is the invoice.",
              "external_images": false
            },
            "headers": {
              "content_type": "multipart/mixed",
              "ip_address": "203.0.113.10",
              "is_tls": true,
              "spf_success": true,
              "dkim_success": true,
              "dmarc_success": true,
              "spam_score": 0.4,
              "list_unsubscribe": null
            },
            "attachments": [
              {
                "attachment_id": "Vj0xQVRUMDE",
                "file_name": "invoice.pdf",
                "mime_type": "application/pdf",
                "size_bytes": 48213,
                "inline": false,
                "content_id": null
              }
            ]
          }
        ],
        "not_found": []
      }
    }
  ]
}

Antwortfelder

  • messages[]

    Die Umschlag- und Statusfelder (folders, labels, to, cc, bcc, references, snoozed_until…) plus das, was Sie in include angefordert haben.

  • messages[].body

    { html, text, external_images }. Das HTML ist roh und unbereinigt.

  • messages[].headers

    content_type, ip_address, is_tls, spf_success, dkim_success, dmarc_success, spam_score, list_unsubscribe, list_id, sender_provider (von wo die E-Mail gesendet wurde, bei der Zustellung verifiziert), rules_matched…

  • messages[].agent_score / agent_reasons

    Nur in Agents und NotSubscribing: die Bewertung der Vorsortierung und was sie ausgelöst hat.

  • messages[].full_headers

    Alles aus headers plus headers_json, received_chain, spf_result, dkim_result, dmarc_result und spam_result.

  • messages[].attachments

    Eine Liste mit attachment_id, file_name, mime_type, size_bytes, inline, content_id und den scan_*-Feldern. Die Datei selbst ist nicht enthalten.

  • not_found

    IDs, die in diesem Postfach nicht existieren.

Einen Anhang herunterladen

Die Anhangliste enthält nie die Binärdaten. Nehmen Sie die attachment_id und laden Sie die Datei über die Route Raw Message herunter.

i

GET /v1/raw?message_id=<message_uid>&attachment_id=<attachment_id>. Der ursprüngliche MIME-Typ kommt in X-Original-Content-Type zurück.

Fehler

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

  • 401TOKEN_EXPIRED

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

  • 401INVALID_TOKEN

    Der Token ist fehlerhaft, unbekannt oder widerrufen.

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

  • CMDINVALID_ARGS

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDINTERNAL

    Serverfehler. Die Details werden nur ins Server-Log geschrieben.