Menerima Email: Membaca

Daftar pesan

Tampilkan pesan satu per satu, tanpa mengelompokkannya menjadi percakapan. Anda juga bisa menampilkan semua pesan yang memiliki label.

POSThttps://g.sendcorex.com/v1command: list_messages

Argumen

  • folderstringopsional

    Folder yang ditampilkan. Default INBOX.

  • limitnumberopsional

    Ukuran halaman, 1 sampai 100. Default 25.

  • cursorstringopsional

    next_cursor dari halaman sebelumnya.

  • is_readbooleanopsional

    Filter berdasarkan status dibaca. Filter ini memindai folder.

  • is_starredbooleanopsional

    Filter berdasarkan bintang. Filter ini memindai folder.

  • is_importantbooleanopsional

    Filter berdasarkan tingkat penting. Filter ini memindai folder.

  • is_spambooleanopsional

    Filter berdasarkan spam. Filter ini memindai folder.

  • afterstringopsional

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

  • beforestringopsional

    Hanya pesan yang diterima sebelum tanggal ini. Format sama seperti after.

  • labelstringopsional

    Tampilkan pesan dengan label ini di semua folder. folder dan filter boolean diabaikan. Tidak peka huruf besar/kecil. after dan before tetap 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_uid

    Id pesan.

  • messages[].thread_id

    Percakapan tempat pesan berada.

  • messages[].folder

    Folder dari entri ini.

  • messages[].subject / preview

    Subjek dan pratinjau singkat.

  • messages[].from_name / from_email

    Pengirim.

  • messages[].has_attachments / size_bytes

    Flag lampiran dan ukuran pesan.

  • messages[].is_read / is_starred / is_important / is_spam

    Status pesan.

  • messages[].snoozed_until

    Kapan pesan yang ditunda jatuh tempo, atau null.

  • messages[].received_at

    Kapan pesan diterima.

  • has_more / next_cursor

    Paginasi.

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.

  • 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.