E-Mails empfangen: Anhänge
Große Datei hochladen
Laden Sie eine Datei bis 25 MB als Binärdaten hoch, außerhalb des 1-MB-JSON von POST /v1. Liefert dieselbe compose_uid und Anhang-ID wie upload_attachment.
https://g.sendcorex.com/v1/attachmentVerwenden Sie diese Route für Dateien über etwa 700 KB. Bei upload_attachment steckt die Datei als Base64 im JSON, das auf 1 MB begrenzt ist, und Base64 macht die Datei etwa 33 % größer.
Senden Sie dann die compose_uid (und optional attachment_ids) in send_email, reply, forward, schedule_send oder save_draft. Senden Sie dieselbe compose_uid erneut, um derselben E-Mail weitere Dateien hinzuzufügen.
Uploads, die nicht innerhalb von 48 Stunden gesendet werden und von keinem Entwurf und keiner geplanten E-Mail verwendet werden, werden gelöscht. Laden Sie die Datei erneut hoch, wenn Sie ATTACHMENT_MISSING erhalten.
Query-Parameter
file_namestringerforderlichDateiname, der dem Empfänger angezeigt wird. Erforderlich bei binärem Body; bei Multipart wird der Name des
file-Teils verwendet.compose_uidstringoptionalFügt die Datei einer E-Mail hinzu, die Sie bereits zusammenstellen. Bei Multipart kann es auch ein Formularfeld sein.
Schnellstart
import axios from 'axios';
import { readFileSync } from 'node:fs';
const res = await axios.post('https://g.sendcorex.com/v1/attachment', readFileSync('invoice.pdf'), {
params: { file_name: 'invoice.pdf' },
headers: {
Authorization: process.env.SENDCOREX_TOKEN,
'Content-Type': 'application/pdf',
},
maxBodyLength: Infinity,
});
const { compose_uid, attachment } = res.data.data;
console.log(compose_uid, attachment.id);Antwort
{
"type": "SUCCESS",
"data": {
"compose_uid": "Vj0xQ01QMDAx",
"attachment": {
"id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
"file_name": "invoice.pdf",
"size_bytes": 3145728,
"content_type": "application/pdf"
}
}
}Antwortfelder
data.compose_uidSenden Sie sie mit den nächsten Uploads derselben E-Mail und mit dem Sendebefehl.
data.attachment.idVerwenden Sie sie in
attachment_idsoderdelete_attachment.
Request-Body
Senden Sie die Datei auf eine von zwei Arten. Eine Datei pro Anfrage.
BinärDer Body ist die Datei selbst. Setzen Sie
Content-Typeauf den Dateityp (zum Beispielapplication/pdf); ohne ihn wird die Datei alsapplication/octet-streamgespeichert.Multipartmultipart/form-datamit der Datei im Feldfile. Optionale Felder:compose_uidundfile_name.
Limits
Pro Datei25 MB.
Pro E-Mail20 Dateien und insgesamt 25 MB.
Pro Postfach50 E-Mails mit noch nicht gesendeten Uploads und insgesamt 500 MB. Das Senden einer E-Mail gibt ihren Anteil sofort frei.
Ungenutzte UploadsWerden nach 48 Stunden gelöscht, wenn kein Entwurf und keine geplante E-Mail sie verwendet. Dateien eines Entwurfs oder einer geplanten E-Mail bleiben, solange diese existiert.
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.
- 400
INVALID_ARGS`file_name` fehlt (binärer Body), das Multipart hat kein `file`-Feld oder mehr als eines, oder `compose_uid` ist ungültig.
- 400
INVALID_ATTACHMENTDie Datei ist leer oder konnte nicht gelesen werden.
- 400
FILE_BLOCKEDDie Datei wurde von der Sicherheitsprüfung blockiert.
- 400
ALREADY_SENTDie `compose_uid` gehört zu einer E-Mail, die bereits gesendet wurde.
- 400
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.
- 413
ATTACHMENTS_TOO_LARGEDie Datei ist größer als 25 MB, die E-Mail überschreitet 25 MB, oder das Postfach hat bereits 500 MB an Uploads, die auf den Versand warten.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.