Recevoir des e-mails : Envoi et confiance
Obtenir le suivi
Renvoie les ouvertures et les clics des e-mails envoyés par cette boîte. Lecture seule.
https://g.sendcorex.com/v1command: get_trackingSeuls les messages envoyés avec suivi apparaissent dans le résultat.
Les ouvertures des bots et des proxys ne sont pas comptées.
Les ouvertures sont une estimation : certaines applications chargent les images automatiquement ou les bloquent.
Le statut de chaque message est conservé pendant 180 jours.
Arguments
idsstring[]obligatoire1 à 200
message_uidde messages envoyés. Ils viennent de Sent, de la réponse desend_email/replyou delist_messages.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "get_tracking",
args: {
ids: [
"Vj0xQUJDMTIz",
"Vj0xQUJDMTI0"
]
}
}
]
},
{ 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_tracking",
"id": "0",
"type": "SUCCESS",
"data": {
"tracking": {
"Vj0xQUJDMTIz": {
"track_opens": true,
"track_clicks": true,
"opens": 3,
"clicks": 1,
"first_open_at": "2026-11-21T07:10:00Z",
"last_open_at": "2026-11-21T09:42:00Z",
"last_click_at": "2026-11-21T09:43:00Z",
"unsubscribe": true,
"unsubscribes": 0,
"recipients": [
{
"email": "ana@empresa.com",
"opens": 3,
"clicks": 1,
"last_at": "2026-11-21T09:43:00Z",
"unsubscribed": false,
"urls": [
{
"url": "https://acme.com/pricing",
"at": "2026-11-21T09:43:00Z",
"clicks": 1
}
]
}
]
}
}
}
}
]
}Champs de la réponse
tracking.<message_uid>Une entrée par message envoyé avec suivi. Un message envoyé sans suivi n’apparaît pas.
track_opens / track_clicksCe qui était suivi au moment de l’envoi de l’e-mail.
opens / clicksTotaux pour l’ensemble des destinataires.
first_open_at / last_open_at / last_click_atPremière et dernière activité (UTC), ou
null.unsubscribe / unsubscribesSi l’e-mail avait un lien de désinscription, et combien de destinataires se sont désinscrits par ce lien.
recipientsPar destinataire :
email,opens,clicks,last_at,unsubscribedeturls(chaque lien cliqué, du plus récent, avecurl,atdu dernier clic etclicks;[]si la personne n’a pas cliqué).
Suivi
Comment les ouvertures et les clics sont mesurés.
Ouvertures
Chaque e-mail contient un pixel invisible. Quand l’application du destinataire le charge, une ouverture est comptée. Certaines applications chargent les images d’elles-mêmes ou les bloquent : le nombre est donc une estimation.
Clics
Chaque lien passe par une redirection qui compte le clic et emmène le destinataire directement vers l’adresse d’origine.
Confidentialité
Les destinataires qui ont refusé le suivi sur la page de préférences ne sont jamais suivis. Pour désactiver le suivi d’un e-mail, envoyez track_opens: false et track_clicks: false.
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_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.