Quarantäne

Markierte E-Mail

Wird eine gesendete E-Mail als potenzieller Spam markiert, liefert die API 403 zurück, statt die Nachricht in die Warteschlange zu stellen. Es wird eine quarantine_id zurückgegeben, damit Sie die E-Mail später prüfen und freigeben können.

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

Nicht zugestellt: Eine E-Mail in Quarantäne wird nicht gesendet. Verwenden Sie /quarantine/release, um sie nach der Prüfung zuzustellen. Der Eintrag läuft nach 3 Stunden ab.

So funktioniert es

  1. 1

    Senden

    Sie rufen /send wie gewohnt auf. Löst der Text oder der Betreff den Spamfilter aus, speichert die API den Roh-Payload in Quarantäne, statt die E-Mail in die Warteschlange zu stellen.

  2. 2

    403 erhalten

    Die Antwort ist 403 Forbidden mit dem Code SPAM_DETECTED, einer detectionId und einer quarantine_id.

  3. 3

    Prüfen

    Prüfen Sie den markierten Inhalt. Ist die E-Mail legitim, rufen Sie innerhalb von 3 Stunden /quarantine/release mit der quarantine_id auf. Text und Betreff werden vor der Zustellung bereinigt.

403-Payload

  • errorstring

    Lesbare Meldung, die erklärt, dass der Inhalt als Spam markiert wurde.

    z. B. "Email content flagged as spam."

  • codestring

    Maschinenlesbarer Fehlercode. Bei markierten E-Mails immer SPAM_DETECTED.

    z. B. "SPAM_DETECTED"

  • detectionIdstring

    Eindeutige ID der Spam-Erkennung. Geben Sie sie an, wenn Sie den Support kontaktieren.

    z. B. "det_8c1e5a92b7d04f36"

  • quarantine_idstring | null

    Eindeutige ID der Nachricht in Quarantäne. Übergeben Sie sie an /quarantine/release, um die E-Mail zuzustellen. Sie ist null, wenn die Nachricht nicht zur Freigabe gespeichert werden konnte.

    z. B. "qtn_3f2a1b4c8e9d4f7a"

  • release_instructionsstring | null

    Ein kurzer Hinweis, wie die E-Mail freigegeben wird. null, wenn es keine quarantine_id gibt.

    z. B. "POST /v3.0/quarantine/release with { quarantine_id }"

  • expires_instring | null

    Wie lange der Quarantäne-Eintrag zur Freigabe verfügbar bleibt.

    z. B. "3 hours"

Schnellstart

import axios from 'axios';

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: 'Hello!',
      body: '<p>Your message here.</p>',
    },
    { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
  );
  console.log('Queued:', response.data.id);
} catch (err) {
  if (err.response?.status === 403 && err.response.data.code === 'SPAM_DETECTED') {
    // Email flagged as spam: save quarantine_id to release it later
    const { quarantine_id, detectionId, expires_in } = err.response.data;
    console.log('Quarantined:', quarantine_id, '| detection:', detectionId, '| expires in', expires_in);
  } else {
    throw err;
  }
}

Antwort

{
  "error": "Email content flagged as spam.",
  "code": "SPAM_DETECTED",
  "detectionId": "det_8c1e5a92b7d04f36",
  "quarantine_id": "qtn_3f2a1b4c8e9d4f7a",
  "release_instructions": "POST /v3.0/quarantine/release with { quarantine_id }",
  "expires_in": "3 hours"
}

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.

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

  • 400MISSING_QUARANTINE_ID

    quarantine_id ist erforderlich.

  • 403RELEASE_LIMIT_REACHED

    Zu viele Quarantäne-Freigaben (Limit: 10 / 3h). Konto wird geprüft.

  • 403QUARANTINE_FORBIDDEN

    Der Quarantäne-Eintrag gehört zu einem anderen Konto.

  • 404QUARANTINE_NOT_FOUND

    Quarantäne-Eintrag nicht gefunden oder bereits verarbeitet.

  • 410QUARANTINE_EXPIRED

    Der Quarantäne-Eintrag ist abgelaufen. Bitte senden Sie die E-Mail erneut.

  • 409QUARANTINE_ALREADY_APPROVED

    Diese E-Mail wurde bereits von unserem Team freigegeben und wird zugestellt. Keine Aktion nötig.

  • 409QUARANTINE_IN_PROGRESS

    Diese E-Mail wird bereits freigegeben (eine andere Anfrage war schneller). Keine Aktion nötig.

  • 500INTERNAL_SERVER_ERROR

    Unerwarteter Serverfehler. Versuchen Sie es erneut.

  • 500QUARANTINE_CORRUPT

    Beschädigter Quarantäne-Payload.

  • 503AUTH_UNAVAILABLE

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