Terima email: Kontak dan audiens
Lihat audiens
Memeriksa audiens sebelum mengirim: berapa orang dan 30 pertama. Hanya baca.
https://g.sendcorex.com/v1command: get_audienceOrang yang berhenti berlangganan selalu dikecualikan.
Tersedia di paket berbayar.
Argumen
segmentstringwajibsubscribed,opened,clicked,both,seg:<segment_id>, ataumsg:<message_uid>:opened|clicked|not_opened.
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "get_audience",
args: {
segment: "opened"
}
}
]
},
{ 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": "get_audience",
"id": "0",
"type": "SUCCESS",
"data": {
"segment": "opened",
"emails": [
"ana@empresa.com"
],
"total": 1240
}
}
]
}Field respons
segmentAudiens yang diminta.
emails30 alamat pertama.
totalBerapa orang yang akan menerimanya.
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_AUDIENCEAudiens tidak valid: grup tidak dikenal, segmen kotak lain, atau pesan yang tidak dikirim kotak ini.
- CMD
PAID_PLAN_REQUIREDLebih dari satu alamat di `to` memerlukan paket berbayar.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.