Menerima Email: Lampiran
Unggah file besar
Unggah file hingga 25 MB sebagai data biner, di luar JSON 1 MB pada POST /v1. Mengembalikan compose_uid dan id lampiran yang sama seperti upload_attachment.
https://g.sendcorex.com/v1/attachmentGunakan rute ini untuk file di atas sekitar 700 KB. Di upload_attachment file dikirim dalam base64 di dalam JSON, yang dibatasi 1 MB, dan base64 membuat file sekitar 33% lebih besar.
Lalu kirim compose_uid (dan opsional attachment_ids) di send_email, reply, forward, schedule_send, atau save_draft. Kirim compose_uid yang sama lagi untuk menambahkan file lain ke email yang sama.
Unggahan yang tidak dikirim dalam 48 jam, dan tidak dipakai oleh draf atau email terjadwal mana pun, akan dihapus. Unggah file lagi jika Anda menerima ATTACHMENT_MISSING.
Query parameter
file_namestringwajibNama file yang ditampilkan ke penerima. Wajib dengan body biner; dengan multipart, nama bagian
fileyang dipakai.compose_uidstringopsionalTambahkan file ke email yang sedang Anda susun. Dengan multipart, ini juga bisa berupa field formulir.
Mulai cepat
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);Respons
{
"type": "SUCCESS",
"data": {
"compose_uid": "Vj0xQ01QMDAx",
"attachment": {
"id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
"file_name": "invoice.pdf",
"size_bytes": 3145728,
"content_type": "application/pdf"
}
}
}Field respons
data.compose_uidKirim bersama unggahan berikutnya untuk email yang sama dan bersama perintah kirim.
data.attachment.idGunakan di
attachment_idsataudelete_attachment.
Body request
Kirim file dengan salah satu dari dua cara. Satu file per request.
BinerBody adalah file itu sendiri. Atur
Content-Typeke tipe file (misalnyaapplication/pdf); tanpa itu, file disimpan sebagaiapplication/octet-stream.Multipartmultipart/form-datadengan file di fieldfile. Field opsional:compose_uiddanfile_name.
Batas
Per file25 MB.
Per email20 file dan total 25 MB.
Per kotak surat50 email dengan unggahan yang belum dikirim, dan total 500 MB. Mengirim email langsung membebaskan bagiannya.
Unggahan tak terpakaiDihapus setelah 48 jam jika tidak dipakai oleh draf atau email terjadwal. File milik draf atau email terjadwal tetap ada selama draf atau email itu ada.
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.
- 400
INVALID_ARGS`file_name` tidak ada (body biner), multipart tidak memiliki field `file` atau memiliki lebih dari satu, atau `compose_uid` tidak valid.
- 400
INVALID_ATTACHMENTFile kosong atau tidak bisa dibaca.
- 400
FILE_BLOCKEDFile diblokir oleh pemindaian keamanan.
- 400
ALREADY_SENT`compose_uid` milik email yang sudah terkirim.
- 400
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.
- 413
ATTACHMENTS_TOO_LARGEFile lebih dari 25 MB, email melebihi 25 MB, atau kotak surat sudah memiliki 500 MB unggahan yang menunggu dikirim.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.