E-Mails empfangen: Anhänge
Anhang hochladen
Laden Sie eine Datei vor dem Senden hoch. Verwenden Sie die zurückgegebene compose_uid in send_email, reply, forward oder schedule_send.
https://g.sendcorex.com/v1command: upload_attachmentOhne compose_uid wird eine neue erstellt. Senden Sie sie mit den nächsten Dateien derselben E-Mail zurück. Jede Datei wird vor dem Speichern geprüft.
Für einzelne Dateien können Sie diesen Schritt auch überspringen und sie direkt in attachments des Sendebefehls mitschicken.
Die gesamte Anfrage ist auf 1 MB begrenzt, und Base64 macht die Datei etwa 33 % größer, daher passen mit diesem Befehl Dateien bis etwa 700 KB. Für größere Dateien (bis 25 MB) verwenden Sie Große Datei hochladen, das die Datei als Binärdaten entgegennimmt.
Limits: 20 Dateien und 25 MB pro E-Mail; pro Postfach 50 E-Mails mit noch nicht gesendeten Uploads und insgesamt 500 MB. Uploads, die nicht innerhalb von 48 Stunden gesendet und nicht von einem Entwurf oder einer geplanten E-Mail verwendet werden, werden gelöscht.
Argumente
file_namestringerforderlichDateiname, der dem Empfänger angezeigt wird.
contentstringerforderlichDie Datei in Base64 (eine data:-URL wird ebenfalls akzeptiert). Die Anfrage ist auf 1 MB begrenzt, also etwa 700 KB Datei.
content_typestringoptionalMIME-Typ. Standard ist
application/octet-stream.compose_uidstringoptionalFügt die Datei einer E-Mail hinzu, die Sie bereits zusammenstellen.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "upload_attachment",
args: {
file_name: "invoice.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "upload_attachment",
"id": "0",
"type": "SUCCESS",
"data": {
"compose_uid": "Vj0xQ01QMDAx",
"attachment": {
"id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
"file_name": "invoice.pdf",
"size_bytes": 48213,
"content_type": "application/pdf"
}
}
}
]
}Antwortfelder
compose_uidSenden Sie sie mit den nächsten Uploads und mit dem Sendebefehl.
attachment.idVerwenden Sie sie in
attachment_idsoderdelete_attachment.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
TOKEN_EXPIREDDer Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.
- 401
INVALID_TOKENDer Token ist fehlerhaft, unbekannt oder widerrufen.
- 429
RATE_LIMITEDMehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.
- CMD
INVALID_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
INVALID_ATTACHMENTDer Inhalt eines Anhangs ist kein gültiges Base64.
- CMD
ATTACHMENTS_TOO_LARGEDie Anhänge der E-Mail ergeben zusammen mehr als 25 MB, oder das Postfach hat bereits 500 MB an Uploads, die auf den Versand warten.
- CMD
TOO_MANY_OPEN_COMPOSESDas Postfach hat 50 E-Mails mit noch nicht gesendeten Uploads. Senden Sie sie oder warten Sie, bis die ungenutzten nach 48 Stunden gelöscht werden.
- CMD
FILE_BLOCKEDEine Datei wurde von der Sicherheitsprüfung blockiert.
- CMD
ALREADY_SENTDie compose_uid gehört zu einer E-Mail, die bereits gesendet wurde.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.