Quarantäne

E-Mail freigeben

Gibt eine E-Mail aus der Quarantäne zur Zustellung frei. Text und Betreff werden vor dem Versand bereinigt. Jede quarantine_id kann nur einmal freigegeben werden.

POSThttps://mail.sendcorex.com/v3.0/quarantine/release
i

Woher kommt die ID? Wenn /send eine Nachricht markiert, liefert es 403 mit einer quarantine_id zurück. SieheMeine Nachrichten werden als Spam markiert.

!

Limits:Ein Quarantäne-Eintrag läuft nach 3 Stunden ab, und Freigaben sind auf 10 pro 3 Stunden begrenzt. Wird die Grenze überschritten, kommt RELEASE_LIMIT_REACHED zurück und das Konto wird überprüft. Prüfen Sie den Inhalt, bevor Sie freigeben.

Body-Parameter

  • quarantine_idstringerforderlich

    Die ID aus der 403-Antwort von /send, als die E-Mail markiert wurde.

    z. B. "qtn_3f2a1b4c8e9d4f7a"

Was bei der Freigabe passiert

  1. 1

    Abruf

    Der Quarantäne-Eintrag wird abgerufen und mit Ihrem Konto abgeglichen. Einträge anderer Konten werden abgelehnt.

  2. 2

    Bereinigung

    Text und Betreff werden bereinigt, um vor der Zustellung verbliebene schädliche Muster zu entfernen.

  3. 3

    Ingest

    Für jeden Empfänger im ursprünglichen Payload wird ein eigener E-Mail-Eintrag vorbereitet und über die interne Ingest-Pipeline versendet.

  4. 4

    Als freigegeben markieren

    Der Quarantäne-Eintrag wird als released: true markiert und der Freigabezähler erhöht. Weitere Aufrufe mit derselben ID werden abgelehnt.

Da Text und Betreff bereinigt werden, kann die zugestellte E-Mail von der ursprünglich gesendeten abweichen.

Schnellstart

import axios from 'axios';

const quarantineId = 'qtn_3f2a1b4c8e9d4f7a';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/quarantine/release',
  { quarantine_id: quarantineId },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

const { success, released, recipients } = response.data;
console.log(`Released to ${recipients} recipient(s)`);

Antwort

{
  "success": true,
  "released": true,
  "code": "QUARANTINE_RELEASED",
  "quarantine_id": "qtn_3f2a1b4c8e9d4f7a",
  "recipients": 1
}

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.

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