Menerima Email: Membaca
Daftar pesan
Tampilkan pesan satu per satu, tanpa mengelompokkannya menjadi percakapan. Anda juga bisa menampilkan semua pesan yang memiliki label.
https://g.sendcorex.com/v1command: list_messagesArgumen
folderstringopsionalFolder yang ditampilkan. Default
INBOX.limitnumberopsionalUkuran halaman, 1 sampai 100. Default 25.
cursorstringopsionalnext_cursordari halaman sebelumnya.is_readbooleanopsionalFilter berdasarkan status dibaca. Filter ini memindai folder.
is_starredbooleanopsionalFilter berdasarkan bintang. Filter ini memindai folder.
is_importantbooleanopsionalFilter berdasarkan tingkat penting. Filter ini memindai folder.
is_spambooleanopsionalFilter berdasarkan spam. Filter ini memindai folder.
afterstringopsionalHanya pesan yang diterima pada atau setelah tanggal ini. RFC 3339,
YYYY-MM-DD(UTC), atau epoch dalam milidetik.beforestringopsionalHanya pesan yang diterima sebelum tanggal ini. Format sama seperti
after.labelstringopsionalTampilkan pesan dengan label ini di semua folder.
folderdan filter boolean diabaikan. Tidak peka huruf besar/kecil.afterdanbeforetetap berfungsi.mis.
"cliente-vip"
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_messages",
args: {
folder: "INBOX",
is_read: false,
limit: 50
}
}
]
},
{ 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": "list_messages",
"id": "0",
"type": "SUCCESS",
"data": {
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"folder": "INBOX",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"has_attachments": false,
"size_bytes": 4821,
"is_read": false,
"is_starred": false,
"is_important": false,
"is_spam": false,
"snoozed_until": null,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}
}
]
}Field respons
messages[].message_uidId pesan.
messages[].thread_idPercakapan tempat pesan berada.
messages[].folderFolder dari entri ini.
messages[].subject / previewSubjek dan pratinjau singkat.
messages[].from_name / from_emailPengirim.
messages[].has_attachments / size_bytesFlag lampiran dan ukuran pesan.
messages[].is_read / is_starred / is_important / is_spamStatus pesan.
messages[].snoozed_untilKapan pesan yang ditunda jatuh tempo, atau
null.messages[].received_atKapan pesan diterima.
has_more / next_cursorPaginasi.
Daftar berdasarkan label
Dengan label, perintah membaca indeks label, jadi hanya pesan berlabel yang diperiksa. Setiap pesan dikembalikan dengan status terkininya di semua folder, jadi Anda mendapatkan folders dan labels, bukan satu folder.
Data respons dengan label
{
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"folders": [
"INBOX"
],
"labels": [
"cliente-vip"
],
"is_read": false,
"is_starred": false,
"is_important": false,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}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_CURSORCursor salah format atau milik akun atau folder lain.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.