Menerima Email: Lampiran
Unggah lampiran
Unggah file sebelum mengirim. Gunakan compose_uid yang dikembalikan di send_email, reply, forward, atau schedule_send.
https://g.sendcorex.com/v1command: upload_attachmentTanpa compose_uid, yang baru akan dibuat. Kirim kembali bersama file berikutnya untuk email yang sama. Setiap file dipindai sebelum disimpan.
Untuk file sekali pakai, Anda juga bisa melewati langkah ini dan mengirimnya langsung di attachments pada perintah kirim.
Seluruh request dibatasi 1 MB, dan base64 membuat file sekitar 33% lebih besar, jadi perintah ini muat file hingga sekitar 700 KB. Untuk file yang lebih besar (hingga 25 MB), gunakan Unggah file besar, yang menerima file sebagai data biner.
Batas: 20 file dan 25 MB per email; per kotak surat, 50 email dengan unggahan yang belum dikirim dan total 500 MB. Unggahan yang tidak dikirim dalam 48 jam, dan tidak dipakai oleh draf atau email terjadwal, akan dihapus.
Argumen
file_namestringwajibNama file yang ditampilkan ke penerima.
contentstringwajibFile dalam base64 (URL data: juga diterima). Request dibatasi 1 MB, jadi sekitar 700 KB file.
content_typestringopsionalTipe MIME. Default
application/octet-stream.compose_uidstringopsionalTambahkan file ke email yang sedang Anda susun.
Mulai cepat
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);Respons
{
"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"
}
}
}
]
}Field respons
compose_uidKirim bersama unggahan berikutnya dan bersama perintah kirim.
attachment.idGunakan di
attachment_idsataudelete_attachment.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
TOKEN_EXPIREDAccess token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.
- 401
INVALID_TOKENToken salah format, tidak dikenal, atau dicabut.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.
- CMD
INVALID_ARGSArgumen wajib tidak ada atau tidak valid.
- CMD
INVALID_ATTACHMENTKonten lampiran bukan base64 yang valid.
- CMD
ATTACHMENTS_TOO_LARGELampiran email totalnya lebih dari 25 MB, atau kotak surat sudah memiliki 500 MB unggahan yang menunggu dikirim.
- CMD
TOO_MANY_OPEN_COMPOSESKotak surat memiliki 50 email dengan unggahan yang belum dikirim. Kirim email tersebut, atau tunggu yang tidak terpakai dihapus setelah 48 jam.
- CMD
FILE_BLOCKEDSebuah file diblokir oleh pemindaian keamanan.
- CMD
ALREADY_SENTcompose_uid milik email yang sudah terkirim.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.