E-Mail

Benutzerdefinierte Header

Fügen Sie Ihren ausgehenden E-Mails benutzerdefinierte Header über das Objekt headers in der Sendeanfrage hinzu.

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

Namensregel:Jeder Header außerhalb der unten aufgeführten reservierten Liste muss mit X- beginnen. Das wird erzwungen, um Header-Injection zu verhindern und durch RFCs reservierte Felder zu schützen.

Reservierte Header

Diese Header brauchen das Präfix X- nicht. Zu den Abmelde-Headern sieheAbmelde-Header.

  • List-Id

    Kennzeichnet die Mailingliste, zu der die E-Mail gehört.

  • X-Report-Abuse

    Eine URL, unter der Empfänger Missbrauch melden können.

  • Feedback-ID

    Kennung, mit der Mailbox-Provider Feedback-Loop-Berichte gruppieren.

  • List-Unsubscribe

    Abmeldemethoden (mailto: und/oder https:).

  • List-Unsubscribe-Post

    Aktiviert die Abmeldung mit einem Klick.

Alle anderen Header

Muss mit X- beginnen. Alles andere wird abgelehnt, bevor die E-Mail in die Warteschlange kommt.

Gültig

  • "X-MyCustomHeader": "testcustom0"
  • "X-CUSTOM-X": "testcustom1"

Ungültig

  • "MyCustomHeader": "testcustom0"
  • → HEADER_NOT_ALLOWED

Schnellstart

import axios from 'axios';

await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: 'user@example.com',
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Welcome aboard!',
    body: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
    replyTo: 'support@yourdomain.com',
    headers: {
      'List-Id': 'My List <mylist.yourdomain.com>',
      'X-Report-Abuse': 'https://yourdomain.com/report-abuse',
      'Feedback-ID': 'campaign123:subscriber456:list789:youraccount',
      'List-Unsubscribe':
        '<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
      'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
      'X-MyCustomHeader': 'testcustom0',
      'X-CUSTOM-X': 'testcustom1',
    },
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

Antwort

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}

Fehler liefern ein JSON-Objekt mit error, code und responseTime.

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