Menerima Email: Membaca

Daftar thread

Tampilkan percakapan dalam sebuah folder, ala Gmail, dengan filter belum dibaca, berbintang, penting, lampiran, dan tanggal.

POSThttps://g.sendcorex.com/v1command: list_threads
i

Setiap item adalah satu percakapan. Buka dengan get_thread atau get_messages menggunakan last_message_uid-nya.

Argumen

  • folderstringopsional

    Folder yang ditampilkan. Default INBOX.

  • limitnumberopsional

    Ukuran halaman, 1 sampai 100. Default 25.

  • cursorstringopsional

    next_cursor dari halaman sebelumnya.

  • is_readbooleanopsional

    false hanya mengembalikan percakapan yang memiliki pesan belum dibaca.

  • is_starredbooleanopsional

    Filter berdasarkan bintang.

  • is_importantbooleanopsional

    Filter berdasarkan tingkat penting.

  • has_attachmentsbooleanopsional

    Filter berdasarkan lampiran.

  • afterstringopsional

    Hanya percakapan yang pesan terakhirnya pada atau setelah tanggal ini (inklusif). RFC 3339, YYYY-MM-DD (UTC), atau epoch dalam milidetik.

    mis. "2026-10-01"

  • beforestringopsional

    Hanya 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_id

    Id percakapan.

  • threads[].folder

    Folder yang sedang ditampilkan.

  • threads[].subject

    Subjek percakapan.

  • threads[].preview

    Pratinjau singkat pesan terbaru.

  • threads[].from_name / from_email

    Pengirim pesan terbaru.

  • threads[].participants

    Semua peserta percakapan.

  • threads[].last_senders

    Siapa yang menulis pesan-pesan terbaru.

  • threads[].message_count

    Pesan di folder ini.

  • threads[].thread_message_count

    Pesan di seluruh percakapan.

  • threads[].unread_count / has_unread

    Pesan belum dibaca di percakapan.

  • threads[].has_starred / has_important / has_attachments

    Flag percakapan.

  • threads[].last_message_uid

    Id untuk membuka percakapan dengan get_messages atau get_thread.

  • threads[].last_message_at

    Tanggal pesan terbaru.

  • has_more / next_cursor

    Paginasi. Kirim next_cursor sebagai cursor untuk 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);
i

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.

  • 401TOKEN_EXPIRED

    Access token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.

  • 401INVALID_TOKEN

    Token salah format, tidak dikenal, atau dicabut.

  • 429RATE_LIMITED

    Lebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.

  • CMDINVALID_ARGS

    Argumen wajib tidak ada atau tidak valid.

  • CMDINVALID_CURSOR

    Cursor salah format atau milik akun atau folder lain.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.