Recevoir des emails : Contacts et audience
Voir l’audience
Vérifie une audience avant l’envoi : combien de personnes et les 30 premières. Lecture seule.
https://g.sendcorex.com/v1command: get_audienceLes personnes désinscrites sont toujours exclues.
Disponible avec les offres payantes.
Arguments
segmentstringobligatoiresubscribed,opened,clicked,both,seg:<segment_id>oumsg:<message_uid>:opened|clicked|not_opened.
Démarrage rapide
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);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "get_audience",
"id": "0",
"type": "SUCCESS",
"data": {
"segment": "opened",
"emails": [
"ana@empresa.com"
],
"total": 1240
}
}
]
}Champs de la réponse
segmentL’audience demandée.
emailsLes 30 premières adresses.
totalCombien de personnes le recevront.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
INVALID_AUDIENCEL’audience n’est pas valide : groupe inconnu, segment d’une autre boîte ou message non envoyé par cette boîte.
- CMD
PAID_PLAN_REQUIREDPlusieurs adresses dans `to` nécessitent une offre payante.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.