Menerima Email: Flag & label
Atur flag
Tandai pesan sebagai dibaca atau belum dibaca, berbintang, dan penting. Berfungsi untuk satu pesan atau satu batch.
https://g.sendcorex.com/v1command: set_flagsPerintah batch menjawab per item, jadi satu id yang tidak ada tidak membuat yang lain gagal.
Argumen
idsstring[]opsionalHingga 100 id pesan.
idstringopsionalSatu id pesan. Gunakan ini atau
ids.is_readbooleanopsionalTandai sebagai dibaca (
true) atau belum dibaca (false).is_starredbooleanopsionalTambah atau hapus bintang.
is_importantbooleanopsionalTambah atau hapus flag penting.
scopestringopsionalmessage(default) atauthread. Hanya memengaruhiis_read.
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "set_flags",
args: {
ids: [
"Vj0xQUJDMTIz"
],
is_read: true,
scope: "thread"
}
}
]
},
{ 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": "set_flags",
"id": "0",
"type": "SUCCESS",
"data": {
"items": [
{
"id": "Vj0xQUJDMTIz",
"ok": true,
"data": {
"changed": 2
}
}
],
"ok_count": 1,
"failed_count": 0
}
}
]
}Field respons
items[].idId yang dirujuk item ini.
items[].oktruejika perubahan berhasil untuk id ini.items[].dataHasil untuk id ini. Hanya jika
okbernilaitrue.items[].code / messageError untuk id ini. Hanya jika
okbernilaifalse.ok_count / failed_countBerapa id yang berhasil dan berapa yang gagal.
Cara kerja flag
is_read + scope: threadMenandai seluruh percakapan.
is_starred / is_important: trueHanya menandai pesan dari
id.is_starred / is_important: falseMenghapus flag di seluruh percakapan. Baris percakapan menampilkan "berbintang", jadi menghapus bintang harus membersihkan semua pesan.
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
NOT_FOUNDPesan, percakapan, atau folder tidak ada untuk token ini.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.