Menerima Email: Membaca
Daftar thread
Tampilkan percakapan dalam sebuah folder, ala Gmail, dengan filter belum dibaca, berbintang, penting, lampiran, dan tanggal.
https://g.sendcorex.com/v1command: list_threadsSetiap item adalah satu percakapan. Buka dengan get_thread atau get_messages menggunakan last_message_uid-nya.
Argumen
folderstringopsionalFolder yang ditampilkan. Default
INBOX.limitnumberopsionalUkuran halaman, 1 sampai 100. Default 25.
cursorstringopsionalnext_cursordari halaman sebelumnya.is_readbooleanopsionalfalsehanya mengembalikan percakapan yang memiliki pesan belum dibaca.is_starredbooleanopsionalFilter berdasarkan bintang.
is_importantbooleanopsionalFilter berdasarkan tingkat penting.
has_attachmentsbooleanopsionalFilter berdasarkan lampiran.
afterstringopsionalHanya percakapan yang pesan terakhirnya pada atau setelah tanggal ini (inklusif). RFC 3339,
YYYY-MM-DD(UTC), atau epoch dalam milidetik.mis.
"2026-10-01"beforestringopsionalHanya percakapan yang pesan terakhirnya sebelum tanggal ini (eksklusif). Format sama seperti
after.mis.
"2026-10-08T00:00:00+08:00"
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_threads",
args: {
folder: "INBOX",
is_read: false,
limit: 20
}
}
]
},
{ 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_threads",
"id": "0",
"type": "SUCCESS",
"data": {
"threads": [
{
"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",
"participants": [
"ana@client.com",
"you@yourdomain.com"
],
"last_senders": [
"ana@client.com"
],
"message_count": 2,
"thread_message_count": 3,
"unread_count": 1,
"has_unread": true,
"has_starred": false,
"has_important": false,
"has_attachments": false,
"last_message_uid": "Vj0xQUJDMTIz",
"last_message_at": "2026-10-09T14:21:07Z"
}
],
"has_more": true,
"next_cursor": "eyJwIjoyfQ"
}
}
]
}Field respons
threads[].thread_idId percakapan.
threads[].folderFolder yang sedang ditampilkan.
threads[].subjectSubjek percakapan.
threads[].previewPratinjau singkat pesan terbaru.
threads[].from_name / from_emailPengirim pesan terbaru.
threads[].participantsSemua peserta percakapan.
threads[].last_sendersSiapa yang menulis pesan-pesan terbaru.
threads[].message_countPesan di folder ini.
threads[].thread_message_countPesan di seluruh percakapan.
threads[].unread_count / has_unreadPesan belum dibaca di percakapan.
threads[].has_starred / has_important / has_attachmentsFlag percakapan.
threads[].last_message_uidId untuk membuka percakapan dengan
get_messagesatauget_thread.threads[].last_message_atTanggal pesan terbaru.
has_more / next_cursorPaginasi. Kirim
next_cursorsebagaicursoruntuk mendapatkan halaman berikutnya.
Filter dan kecepatan
is_read: false, is_starred: true, dan is_important: true memakai indeks sendiri, jadi hanya percakapan yang cocok yang diperiksa, bukan seluruh folder. Jika digabung, satu indeks dipakai (bintang, lalu penting, lalu belum dibaca) dan sisanya difilter di atasnya. after dan before adalah rentang kunci, jadi tidak ada yang dipindai di luar periode. has_attachments dan nilai false dari bintang dan penting tetap memindai folder.
Percakapan belum dibaca dalam rentang tanggal
{
"commands": [
{
"command": "list_threads",
"args": {
"is_read": false,
"after": "2026-10-01",
"before": "2026-10-08T00:00:00+08:00"
}
}
]
}Paginasi
Jika has_more bernilai true, panggil perintah lagi dengan cursor diisi next_cursor.
Node.js
let cursor;
const threads = [];
do {
const [result] = await call({
command: 'list_threads',
args: { folder: 'INBOX', limit: 100, ...(cursor ? { cursor } : {}) },
});
threads.push(...result.data.threads);
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);call adalah helper apa pun yang mengirim POST { commands: [...] } ke /v1 dan mengembalikan results, seperti di Run Commands.
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.