Anhänge senden
Hängen Sie Dateien an jede E-Mail an, indem Sie das Array attachments in den Sende-Payload aufnehmen. Dateien müssen base64-kodiert sein, und Sie können mehrere Anhänge in einem Aufruf mitsenden.
https://mail.sendcorex.com/v3.0/send Anhänge verwenden denselben Endpoint wie E-Mail senden. Fügen Sie das Array attachments neben den anderen Body-Parametern hinzu.
Anhang-Parameter
Jedes Element im Array attachments ist ein Objekt mit den folgenden Feldern.
filenamestringerforderlichDer Dateiname, den der Empfänger in seinem E-Mail-Client sieht.
z. B.
"invoice.pdf"contentstringerforderlichDer Dateiinhalt als base64-kodierter String.
z. B.
"JVBERi0xLjQKJeLjz9MK..."encodingstringerforderlichDie Kodierung von content. Muss "base64" sein.
z. B.
"base64"
Schnellstart
import axios from 'axios';
import fs from 'fs';
const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');
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: 'Your Invoice #1042',
body: '<p>Please find your invoice attached.</p>',
attachments: [
{
filename: 'invoice.pdf',
content: fileContent,
encoding: 'base64',
},
],
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id, ids, recipients } = response.data;
console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
// Attachment blocked for security reasons. There is no quarantine record.
console.log('Blocked:', err.response.data.riskLevel);
} else {
throw err;
}
}Antwort
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"recipients": 1,
"scheduledAt": null
}Mein Anhang wurde blockiert
Um unsere Plattform und die Absenderreputation aller Kunden zu schützen, werden Anhänge geprüft, bevor eine E-Mail in die Warteschlange kommt. Gilt eine Datei als unsicher, liefert die Anfrage 400 mit dem Code DANGEROUS_ATTACHMENT zurück und die E-Mail wird nicht gesendet.
Anhang blockiert
{
"error": "One or more attachments were blocked for security reasons.",
"code": "DANGEROUS_ATTACHMENT",
"riskLevel": "high"
}errorEine lesbare Meldung, die erklärt, dass ein Anhang blockiert wurde.
codeBei dieser Antwort immer DANGEROUS_ATTACHMENT.
riskLevelDie dem blockierten Anhang zugewiesene Risikostufe. Geben Sie sie an, wenn Sie den Support kontaktieren.
Für diesen Fehler gibt es keinen Quarantäne-Eintrag.Anders als markierte E-Mails kann ein blockierter Anhang nicht mit /quarantine/release freigegeben werden. Das ist ein bewusster Schutz vor Spammern und missbräuchlichen Absendern, daher wird die E-Mail nie für eine spätere Zustellung zurückgehalten.
Was soll ich tun?
Automatische Prüfungen können gelegentlich eine legitime Datei markieren. Wenn Sie diesen Anhang senden müssen, kontaktieren Sie unser Support-Team. Unser Team kennt dieses Verhalten, und wenn sich eine Blockierung als False Positive herausstellt, prüfen wir sie und nehmen die nötigen Anpassungen vor.
Damit wir es schneller lösen können, geben Sie Folgendes an:
- Dateiname und Dateityp des Anhangs
- Den von der API zurückgegebenen riskLevel
- Wofür die Datei in Ihrem Produkt verwendet wird
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
DOMAIN_NOT_VALIDATEDAbsender-Domain nicht verifiziert.
- 401
LISTED_SPAM_HAUSDie Absender-Domain ist bei Spamhaus gelistet.
- 401
ISP_DOMAIN_BLOCKEDDer Versand von bekannten Domains (gmail.com, outlook.com usw.) ist nicht erlaubt.
- 401
FROM_HEADER_DOMAIN_MISMATCHDomain des From-Headers ist für diesen Absender nicht autorisiert.
- 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
INVALID_JSONDer Request-Body ist kein gültiges JSON.
- 400
MISSING_FROMDas Feld from fehlt oder ist leer.
- 400
INVALID_FROM_FORMATDas Feld from muss eine gültige E-Mail-Adresse sein.
- 400
MISSING_SENDERNAMEDas Feld senderName fehlt oder ist leer.
- 400
INVALID_SENDERNAME_FORMATDas Feld senderName enthält ungültige Zeichen.
- 400
MISSING_SUBJECTDas Feld subject fehlt oder ist leer.
- 400
MISSING_BODYDas Feld body fehlt oder ist leer.
- 400
MISSING_TOADDRESSDas Feld to fehlt oder ist leer.
- 400
MISSING_TODas Feld to fehlt oder ist leer.
- 400
INVALID_TOADDRESSEine oder mehrere Empfängeradressen sind fehlerhaft.
- 400
TOADDRESS_LIMIT_EXCEEDEDMehr als 50 Empfänger im Array to.
- 400
INVALID_CCADDRESSEine oder mehrere cc-Adressen sind fehlerhaft.
- 400
INVALID_BCCADDRESSEine oder mehrere bcc-Adressen sind fehlerhaft.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc und bcc haben zusammen mehr als 50 eindeutige Empfänger.
- 400
INVALID_SCHEDULED_ATscheduled_at ist kein gültiges Datum oder liegt in der Vergangenheit.
- 400
INVALID_SENDER_FORMATDas Format der Absenderadresse ist ungültig.
- 400
HEADER_NOT_ALLOWEDDer Schlüssel des eigenen Headers steht nicht auf der Liste der erlaubten (List-Unsubscribe, List-Id, X-* usw.).
- 400
INVALID_HEADER_VALUEDer Header-Wert enthält ungültige Zeichen (CR/LF nicht erlaubt).
- 400
DANGEROUS_ATTACHMENTEin oder mehrere Anhänge wurden aus Sicherheitsgründen blockiert.
- 400
INVALID_ATTACHMENTDer Inhalt eines Anhangs ist kein gültiges base64.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe ist true, aber der body enthält keinen Abmelde-Platzhalter ([unsubscribe_url], [unsubscribe], [unsub_url] oder [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDDas Konto ist vorübergehend eingeschränkt.
- 403
DAILY_LIMITTägliches Versandlimit erreicht.
- 403
MARKETING_LIMIT_REACHEDTä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.
- 403
FORBIDDEN_HTML_CONTENTDas 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.
- 403
SPAM_DETECTEDE-Mail-Inhalt als Spam erkannt. Die Antwort enthält die quarantine_id und Anweisungen zur Freigabe.
- 403
SENDER_NAME_MISMATCHMehrere Absendernamen für dieselbe Adresse erkannt.
- 403
FOLLOWUP_PATTERN_DETECTEDE-Mail-Inhalt als wiederholtes verdächtiges Follow-up-Muster erkannt.
- 403
SCAM_PATTERN_DETECTEDE-Mail-Inhalt als Betrugsmuster erkannt.
- 403
ACCOUNT_SUSPENDED_SPOOFINGKonto wegen wiederholter Versuche, den From-Header zu fälschen, gesperrt.
- 409
IDEMPOTENCY_IN_PROGRESSEine Anfrage mit demselben Idempotency-Key wird noch verarbeitet. Warte (Retry-After: 1) und wiederhole mit demselben Schlüssel.
- 422
IDEMPOTENCY_KEY_REUSEDDieser Idempotency-Key wurde bereits mit einem anderen Body verwendet. Nutze für jede neue E-Mail einen neuen Schlüssel.
- 500
INTERNAL_SERVER_ERRORUnerwarteter Serverfehler. Versuchen Sie es erneut.
- 500
PARSE_ERRORE-Mail-Inhalt konnte nicht verarbeitet werden (MIME-Parse-Fehler).
- 500
PERSIST_FAILEDE-Mail konnte nicht in die Warteschlange gestellt werden (Fehler beim Speichern in der Datenbank).
- 503
AUTH_UNAVAILABLEDer API-Schlüssel konnte gerade nicht geprüft werden. Versuchen Sie es erneut.
- 503
UNSUBSCRIBE_UNAVAILABLEDienst für Abmeldelinks vorübergehend nicht verfügbar. Versuchen Sie es später erneut.