E-Mail

Anhänge senden

Hängen Sie Dateien an jede E-Mail an, indem Sie das Array attachments in den Sende-Payload aufnehmen. Dateien müssen base64-kodiert sein, und Sie können mehrere Anhänge in einem Aufruf mitsenden.

POSThttps://mail.sendcorex.com/v3.0/send
i

Anhänge verwenden denselben Endpoint wie E-Mail senden. Fügen Sie das Array attachments neben den anderen Body-Parametern hinzu.

Anhang-Parameter

Jedes Element im Array attachments ist ein Objekt mit den folgenden Feldern.

  • filenamestringerforderlich

    Der Dateiname, den der Empfänger in seinem E-Mail-Client sieht.

    z. B. "invoice.pdf"

  • contentstringerforderlich

    Der Dateiinhalt als base64-kodierter String.

    z. B. "JVBERi0xLjQKJeLjz9MK..."

  • encodingstringerforderlich

    Die Kodierung von content. Muss "base64" sein.

    z. B. "base64"

Schnellstart

import axios from 'axios';
import fs from 'fs';

const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');

try {
  const response = await axios.post(
    'https://mail.sendcorex.com/v3.0/send',
    {
      to: 'user@example.com',
      from: 'noreply@yourdomain.com',
      senderName: 'My App',
      subject: 'Your Invoice #1042',
      body: '<p>Please find your invoice attached.</p>',
      attachments: [
        {
          filename: 'invoice.pdf',
          content: fileContent,
          encoding: 'base64',
        },
      ],
    },
    { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
  );

  const { id, ids, recipients } = response.data;
  console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
  if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
    // Attachment blocked for security reasons. There is no quarantine record.
    console.log('Blocked:', err.response.data.riskLevel);
  } else {
    throw err;
  }
}

Antwort

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "recipients": 1,
  "scheduledAt": null
}

Mein Anhang wurde blockiert

Um unsere Plattform und die Absenderreputation aller Kunden zu schützen, werden Anhänge geprüft, bevor eine E-Mail in die Warteschlange kommt. Gilt eine Datei als unsicher, liefert die Anfrage 400 mit dem Code DANGEROUS_ATTACHMENT zurück und die E-Mail wird nicht gesendet.

400

Anhang blockiert

{
  "error": "One or more attachments were blocked for security reasons.",
  "code": "DANGEROUS_ATTACHMENT",
  "riskLevel": "high"
}
  • error

    Eine lesbare Meldung, die erklärt, dass ein Anhang blockiert wurde.

  • code

    Bei dieser Antwort immer DANGEROUS_ATTACHMENT.

  • riskLevel

    Die dem blockierten Anhang zugewiesene Risikostufe. Geben Sie sie an, wenn Sie den Support kontaktieren.

!

Für diesen Fehler gibt es keinen Quarantäne-Eintrag.Anders als markierte E-Mails kann ein blockierter Anhang nicht mit /quarantine/release freigegeben werden. Das ist ein bewusster Schutz vor Spammern und missbräuchlichen Absendern, daher wird die E-Mail nie für eine spätere Zustellung zurückgehalten.

Was soll ich tun?

Automatische Prüfungen können gelegentlich eine legitime Datei markieren. Wenn Sie diesen Anhang senden müssen, kontaktieren Sie unser Support-Team. Unser Team kennt dieses Verhalten, und wenn sich eine Blockierung als False Positive herausstellt, prüfen wir sie und nehmen die nötigen Anpassungen vor.

Damit wir es schneller lösen können, geben Sie Folgendes an:

  • Dateiname und Dateityp des Anhangs
  • Den von der API zurückgegebenen riskLevel
  • Wofür die Datei in Ihrem Produkt verwendet wird
Support kontaktieren →

Fehler liefern ein JSON-Objekt mit error und code.

  • 401MISSING_AUTH_HEADER

    Kein Authorization-Header vorhanden.

  • 401INVALID_API_KEY

    Der API-Schlüssel ist ungültig oder widerrufen.

  • 401ACCOUNT_BLOCKED

    Das Konto wurde gesperrt.

  • 401NO_CREDITS_LEFT

    Nicht genug E-Mail-Credits für alle Empfänger. Jede Adresse in to, cc und bcc verbraucht 1 Credit.

  • 401DOMAIN_NOT_VALIDATED

    Absender-Domain nicht verifiziert.

  • 401LISTED_SPAM_HAUS

    Die Absender-Domain ist bei Spamhaus gelistet.

  • 401ISP_DOMAIN_BLOCKED

    Der Versand von bekannten Domains (gmail.com, outlook.com usw.) ist nicht erlaubt.

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Domain des From-Headers ist für diesen Absender nicht autorisiert.

  • 401USER_NOT_FOUND

    Benutzer nicht gefunden.

  • 401MISSING_USER_PRIVILEGES

    Fehlende Benutzerrechte.

  • 401EMAIL_CREDITS_NOT_FOUND

    Fehler beim Abrufen der E-Mail-Credits.

  • 401EMAIL_NOT_VALIDATED

    Die E-Mail-Adresse des Kontos wurde noch nicht verifiziert.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API-Schlüssel wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.

  • 429IP_TEMPORARILY_BLOCKED

    Anfragende IP wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Zu viele gleichzeitige Anfragen von dieser IP. Versuchen Sie es gleich erneut.

  • 400INVALID_JSON

    Der Request-Body ist kein gültiges JSON.

  • 400MISSING_FROM

    Das Feld from fehlt oder ist leer.

  • 400INVALID_FROM_FORMAT

    Das Feld from muss eine gültige E-Mail-Adresse sein.

  • 400MISSING_SENDERNAME

    Das Feld senderName fehlt oder ist leer.

  • 400INVALID_SENDERNAME_FORMAT

    Das Feld senderName enthält ungültige Zeichen.

  • 400MISSING_SUBJECT

    Das Feld subject fehlt oder ist leer.

  • 400MISSING_BODY

    Das Feld body fehlt oder ist leer.

  • 400MISSING_TOADDRESS

    Das Feld to fehlt oder ist leer.

  • 400MISSING_TO

    Das Feld to fehlt oder ist leer.

  • 400INVALID_TOADDRESS

    Eine oder mehrere Empfängeradressen sind fehlerhaft.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Mehr als 50 Empfänger im Array to.

  • 400INVALID_CCADDRESS

    Eine oder mehrere cc-Adressen sind fehlerhaft.

  • 400INVALID_BCCADDRESS

    Eine oder mehrere bcc-Adressen sind fehlerhaft.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc und bcc haben zusammen mehr als 50 eindeutige Empfänger.

  • 400INVALID_SCHEDULED_AT

    scheduled_at ist kein gültiges Datum oder liegt in der Vergangenheit.

  • 400INVALID_SENDER_FORMAT

    Das Format der Absenderadresse ist ungültig.

  • 400HEADER_NOT_ALLOWED

    Der Schlüssel des eigenen Headers steht nicht auf der Liste der erlaubten (List-Unsubscribe, List-Id, X-* usw.).

  • 400INVALID_HEADER_VALUE

    Der Header-Wert enthält ungültige Zeichen (CR/LF nicht erlaubt).

  • 400DANGEROUS_ATTACHMENT

    Ein oder mehrere Anhänge wurden aus Sicherheitsgründen blockiert.

  • 400INVALID_ATTACHMENT

    Der Inhalt eines Anhangs ist kein gültiges base64.

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe ist true, aber der body enthält keinen Abmelde-Platzhalter ([unsubscribe_url], [unsubscribe], [unsub_url] oder [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    Das Konto ist vorübergehend eingeschränkt.

  • 403DAILY_LIMIT

    Tägliches Versandlimit erreicht.

  • 403MARKETING_LIMIT_REACHED

    Tägliches Marketing-Limit des Free-Plans erreicht: 30 Marketing- oder Kaltakquise-E-Mails pro Tag, pro Empfänger gezählt in einem gleitenden 24-Stunden-Fenster. Die Antwort enthält limit, used, recipients und upgradeUrl. Transaktionale E-Mails werden weiter versendet; nichts wird in die Warteschlange gestellt.

  • 403FORBIDDEN_HTML_CONTENT

    Das HTML enthält aktive Inhalte, die in E-Mails nicht erlaubt sind (script, iframe, form, input, button, embed, object, svg, on*-Handler, javascript:-Links, meta refresh…). Die Antwort listet die Funde auf. Verwenden Sie ein gestyltes <a> statt Buttons oder Formularen.

  • 403SPAM_DETECTED

    E-Mail-Inhalt als Spam erkannt. Die Antwort enthält die quarantine_id und Anweisungen zur Freigabe.

  • 403SENDER_NAME_MISMATCH

    Mehrere Absendernamen für dieselbe Adresse erkannt.

  • 403FOLLOWUP_PATTERN_DETECTED

    E-Mail-Inhalt als wiederholtes verdächtiges Follow-up-Muster erkannt.

  • 403SCAM_PATTERN_DETECTED

    E-Mail-Inhalt als Betrugsmuster erkannt.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Konto wegen wiederholter Versuche, den From-Header zu fälschen, gesperrt.

  • 409IDEMPOTENCY_IN_PROGRESS

    Eine Anfrage mit demselben Idempotency-Key wird noch verarbeitet. Warte (Retry-After: 1) und wiederhole mit demselben Schlüssel.

  • 422IDEMPOTENCY_KEY_REUSED

    Dieser Idempotency-Key wurde bereits mit einem anderen Body verwendet. Nutze für jede neue E-Mail einen neuen Schlüssel.

  • 500INTERNAL_SERVER_ERROR

    Unerwarteter Serverfehler. Versuchen Sie es erneut.

  • 500PARSE_ERROR

    E-Mail-Inhalt konnte nicht verarbeitet werden (MIME-Parse-Fehler).

  • 500PERSIST_FAILED

    E-Mail konnte nicht in die Warteschlange gestellt werden (Fehler beim Speichern in der Datenbank).

  • 503AUTH_UNAVAILABLE

    Der API-Schlüssel konnte gerade nicht geprüft werden. Versuchen Sie es erneut.

  • 503UNSUBSCRIBE_UNAVAILABLE

    Dienst für Abmeldelinks vorübergehend nicht verfügbar. Versuchen Sie es später erneut.