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.
https://mail.sendcorex.com/v3.0/sendNicht 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
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
403 erhalten
Die Antwort ist 403 Forbidden mit dem Code SPAM_DETECTED, einer detectionId und einer quarantine_id.
- 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
errorstringLesbare Meldung, die erklärt, dass der Inhalt als Spam markiert wurde.
z. B.
"Email content flagged as spam."codestringMaschinenlesbarer Fehlercode. Bei markierten E-Mails immer SPAM_DETECTED.
z. B.
"SPAM_DETECTED"detectionIdstringEindeutige ID der Spam-Erkennung. Geben Sie sie an, wenn Sie den Support kontaktieren.
z. B.
"det_8c1e5a92b7d04f36"quarantine_idstring | nullEindeutige 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 | nullEin 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 | nullWie 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
Alle Fehlercodes →Fehler liefern ein JSON-Objekt mit error und code.
- 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.