Menerima Email: Mengatur

Hapus

Hapus pesan secara permanen. Hanya pesan di Sampah atau Spam yang bisa dihapus.

POSThttps://g.sendcorex.com/v1command: delete
!

Tindakan ini tidak bisa dibatalkan. Untuk memindahkan pesan ke sampah, gunakan move dengan to_folder: "Trash".

i

Pesan yang juga ada di folder lain (misalnya balasan di Sent) hanya dihapus dari Sampah. Pesan itu tidak dimusnahkan.

Argumen

  • idsstring[]opsional

    Hingga 100 id pesan.

  • idstringopsional

    Satu id pesan. Gunakan ini atau ids.

  • from_folderstringwajib

    Harus Trash atau Spam. Selain itu akan gagal dengan NOT_IN_TRASH.

  • scopestringopsional

    thread (default) atau message.

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "delete",
        args: {
          id: "Vj0xQUJDMTIz",
          from_folder: "Trash"
        }
      }
    ]
  },
  { 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": "delete",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "items": [
          {
            "id": "Vj0xQUJDMTIz",
            "ok": true,
            "data": {
              "changed": 1,
              "deleted": 1,
              "removed": 0
            }
          }
        ],
        "ok_count": 1,
        "failed_count": 0
      }
    }
  ]
}

Field respons

  • items[].data.changed

    Entri yang diubah.

  • items[].data.deleted

    Pesan yang dihapus selamanya.

  • items[].data.removed

    Pesan yang hanya dikeluarkan dari folder karena juga ada di folder lain.

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.

  • CMDNOT_FOUND

    Pesan, percakapan, atau folder tidak ada untuk token ini.

  • CMDNOT_IN_TRASH

    delete hanya berfungsi pada pesan di Sampah atau Spam. Gunakan move untuk memindahkan pesan ke Sampah terlebih dahulu.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.