Menerima Email: Folder & penghitung

Daftar folder

Tampilkan folder sistem dan folder kustom Anda, beserta total dan jumlah belum dibaca masing-masing.

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

Hasil di-cache selama 1,5 detik.

Argumen

Endpoint ini tidak menerima argumen.

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "list_folders"
      }
    ]
  },
  { 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_folders",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "folders": [
          {
            "folder": "INBOX",
            "name": "INBOX",
            "system": true,
            "total": 12,
            "unread": 3
          },
          {
            "folder": "Sent",
            "name": "Sent",
            "system": true,
            "total": 8,
            "unread": 0
          },
          {
            "folder": "projeto-x",
            "name": "Projeto X",
            "system": false,
            "total": 4,
            "unread": 1
          }
        ]
      }
    }
  ]
}

Field respons

  • folders[].folder

    Pengenal folder (slug). Gunakan di perintah lain.

  • folders[].name

    Nama tampilan.

  • folders[].system

    true untuk folder sistem, false untuk folder kustom.

  • folders[].total

    Jumlah entri di folder.

  • folders[].unread

    Jumlah entri belum dibaca di folder.

Folder sistem

INBOX, Sent, Archive, Trash, Drafts, Spam, Promotions, Snoozed, Scheduled (email yang menunggu dikirim), Agents (ditulis oleh agen AI), dan NotSubscribing (menyatakan tidak akan membeli atau berlangganan). Alias seperti inbox, archived, draft, junk, promotion, dan not-subscribing diterima di mana pun folder diharapkan.

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.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.