Logs: Lesen

Logs abrufen

Lesen Sie bis zu 50 Logs per E-Mail-ID, der `id`, die Sie beim Senden erhalten. Fügen Sie `include_content` hinzu, um das zugestellte HTML zu erhalten.

POSThttps://g.sendcorex.com/v1/logscommand: get_logs
i

Erfordert den Scope logs:read für Ihren API key.

i

Eine ID nachzuschlagen kostet gleich viel, egal wie viele E-Mails Sie senden: Dahinter steckt kein Scan.

Argumente

  • idsstring[]optional

    Bis zu 50 E-Mail-IDs (UUIDs). Doppelte IDs zählen einmal.

    z. B. ["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]

  • idstringoptional

    Eine einzelne E-Mail-ID. Verwenden Sie dies oder ids.

    z. B. "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"

  • include_contentbooleanoptional

    Liefert zusätzlich das HTML jeder E-Mail. Damit liegt das Limit bei 10 IDs pro Befehl.

    z. B. true

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/logs',
  {
    commands: [
      {
        command: "get_logs",
        args: {
          ids: [
            "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
            "00000000-0000-4000-8000-000000000000"
          ]
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

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_logs",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "data": {
        "logs": [
          {
            "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
            "to": "ana@acme.com",
            "from": "noreply@yourdomain.com",
            "domain": "acme.com",
            "from_domain": "yourdomain.com",
            "subject": "Your order #1042 has shipped",
            "status": "delivered",
            "status_code": 2,
            "response": "250 2.0.0 OK 1760684401 a1si123456",
            "message": null,
            "blocked": false,
            "block_reason": null,
            "retries": 0,
            "tracking_id": "7CK-JDL-Y1L-20261017",
            "sent_at": "2026-10-17T06:00:01.204Z",
            "updated_at": "2026-10-17T06:00:02.913Z"
          }
        ],
        "not_found": [
          "00000000-0000-4000-8000-000000000000"
        ]
      }
    }
  ]
}

Antwortfelder

  • logs

    Die gefundenen Logs, in der angefragten Reihenfolge.

  • not_found

    Die IDs, die in Ihrem Konto nicht existieren, älter als 60 Tage sind oder zu Warm-up-E-Mails gehören.

  • logs[].id

    Die E-Mail-ID (eine UUID). Es ist die id, die Sie beim Senden erhalten, und die Sie an Get Logs übergeben.

  • logs[].to / logs[].domain

    Der Empfänger und die Domain des Empfängers.

  • logs[].from_domain

    Die Domain des Absenders (der Teil nach dem @ in from).

  • logs[].from

    Die Absenderadresse.

  • logs[].subject

    Die Betreffzeile.

  • logs[].status

    delivered, bounced, spam, rate_limited oder not_sent. status_code ist dasselbe als Zahl.

  • logs[].response

    Was der Empfängerserver geantwortet hat, zum Beispiel 250 2.0.0 OK oder der 550-Bounce-Grund.

  • logs[].message

    Zusätzliche Details von Sendcorex zur Zustellung, falls vorhanden.

  • logs[].blocked / logs[].block_reason

    true, wenn Sendcorex nicht an diesen Empfänger gesendet hat (unterdrückt oder eingeschränkt), und der Grund.

  • logs[].retries

    Wie oft die Zustellung erneut versucht wurde.

  • logs[].tracking_id

    Die interne Zustell-ID. Bounce- und Beschwerde-Webhooks tragen denselben Wert.

  • logs[].sent_at / logs[].updated_at

    Wann die E-Mail gesendet wurde und wann sich ihr Status zuletzt geändert hat. ISO 8601, UTC.

  • logs[].content.html

    Das zugestellte HTML. Nur mit include_content: true; null, wenn der Body nicht gespeichert wurde.

Den Body lesen

Der Body ist der schwerste Teil eines Logs, daher kommt er nur auf Anfrage zurück. Es ist das HTML, wie es zugestellt wurde: War Tracking aktiv, kann es das Tracking-Pixel und umgeschriebene Links enthalten.

Request-Body

{
  "commands": [
    {
      "command": "get_logs",
      "args": {
        "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
        "include_content": true
      }
    }
  ]
}
!

Das Rendern dieses HTML kann das Tracking-Pixel laden und als Öffnung zählen. Zeigen Sie es in einem Sandbox-iframe mit blockierten externen Bildern an, so wie das Dashboard.

Details zu einer Seite von List Logs

Verketten Sie die beiden Befehle mit $ref: Die IDs aus der Liste gehen direkt an Get Logs, in einem einzigen Request.

Request-Body

{
  "commands": [
    {
      "command": "list_logs",
      "id": "bounces",
      "args": {
        "status": "bounced",
        "limit": 10
      }
    },
    {
      "command": "get_logs",
      "args": {
        "ids": {
          "$ref": "bounces",
          "path": "logs/*/id"
        },
        "include_content": true
      }
    }
  ]
}

Fehler

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

  • 401INVALID_API_KEY

    Der API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.

  • 429RATE_LIMITED

    Mehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.

  • CMDMISSING_SCOPE

    Der API key hat `logs:read` nicht.

  • CMDINVALID_ARGS

    Ein Argument ist ungültig: unbekannter Status, Empfänger ohne vollständige E-Mail-Adresse, limit außerhalb des Bereichs, ID, die keine UUID ist, after später als before…

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.