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.
https://mail.sendcorex.com/v3.0/quarantine/releaseWoher 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_idstringerforderlichDie ID aus der 403-Antwort von /send, als die E-Mail markiert wurde.
z. B.
"qtn_3f2a1b4c8e9d4f7a"
Was bei der Freigabe passiert
- 1
Abruf
Der Quarantäne-Eintrag wird abgerufen und mit Ihrem Konto abgeglichen. Einträge anderer Konten werden abgelehnt.
- 2
Bereinigung
Text und Betreff werden bereinigt, um vor der Zustellung verbliebene schädliche Muster zu entfernen.
- 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
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
Alle Fehlercodes →Fehler liefern ein JSON-Objekt mit error, code und responseTime.
- 401
MISSING_AUTH_HEADERKein Authorization-Header vorhanden.
- 401
INVALID_API_KEYDer API-Schlüssel ist ungültig oder widerrufen.
- 401
ACCOUNT_BLOCKEDDas Konto wurde gesperrt.
- 401
NO_CREDITS_LEFTNicht genug E-Mail-Credits für alle Empfänger. Jede Adresse in to, cc und bcc verbraucht 1 Credit.
- 401
USER_NOT_FOUNDBenutzer nicht gefunden.
- 401
MISSING_USER_PRIVILEGESFehlende Benutzerrechte.
- 401
EMAIL_CREDITS_NOT_FOUNDFehler beim Abrufen der E-Mail-Credits.
- 401
EMAIL_NOT_VALIDATEDDie E-Mail-Adresse des Kontos wurde noch nicht verifiziert.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI-Schlüssel wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.
- 429
IP_TEMPORARILY_BLOCKEDAnfragende IP wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSZu viele gleichzeitige Anfragen von dieser IP. Versuchen Sie es gleich erneut.
- 400
MISSING_QUARANTINE_IDquarantine_id ist erforderlich.
- 403
RELEASE_LIMIT_REACHEDZu viele Quarantäne-Freigaben (Limit: 10 / 3h). Konto wird geprüft.
- 403
QUARANTINE_FORBIDDENDer Quarantäne-Eintrag gehört zu einem anderen Konto.
- 404
QUARANTINE_NOT_FOUNDQuarantäne-Eintrag nicht gefunden oder bereits verarbeitet.
- 410
QUARANTINE_EXPIREDDer Quarantäne-Eintrag ist abgelaufen. Bitte senden Sie die E-Mail erneut.
- 409
QUARANTINE_ALREADY_APPROVEDDiese E-Mail wurde bereits von unserem Team freigegeben und wird zugestellt. Keine Aktion nötig.
- 409
QUARANTINE_IN_PROGRESSDiese E-Mail wird bereits freigegeben (eine andere Anfrage war schneller). Keine Aktion nötig.
- 500
INTERNAL_SERVER_ERRORUnerwarteter Serverfehler. Versuchen Sie es erneut.
- 500
QUARANTINE_CORRUPTBeschädigter Quarantäne-Payload.
- 503
AUTH_UNAVAILABLEDer API-Schlüssel konnte gerade nicht geprüft werden. Versuchen Sie es erneut.