Recevoir des e-mails : Lecture
Lister les messages
Listez les messages un par un, sans les regrouper en conversations. Vous pouvez aussi lister tous les messages qui portent un libellé.
https://g.sendcorex.com/v1command: list_messagesArguments
folderstringfacultatifDossier à lister. Par défaut
INBOX.limitnumberfacultatifTaille de page, de 1 à 100. Par défaut 25.
cursorstringfacultatifLe
next_cursorde la page précédente.is_readbooleanfacultatifFiltre par état de lecture. Ce filtre parcourt le dossier.
is_starredbooleanfacultatifFiltre par étoile. Ce filtre parcourt le dossier.
is_importantbooleanfacultatifFiltre par importance. Ce filtre parcourt le dossier.
is_spambooleanfacultatifFiltre par spam. Ce filtre parcourt le dossier.
afterstringfacultatifUniquement les messages reçus à cette date ou après. RFC 3339,
YYYY-MM-DD(UTC) ou epoch en millisecondes.beforestringfacultatifUniquement les messages reçus avant cette date. Mêmes formats que
after.labelstringfacultatifListe les messages portant ce libellé dans tous les dossiers.
folderet les filtres booléens sont ignorés. Insensible à la casse.afteretbeforefonctionnent toujours.ex. :
"cliente-vip"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_messages",
args: {
folder: "INBOX",
is_read: false,
limit: 50
}
}
]
},
{ 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": "list_messages",
"id": "0",
"type": "SUCCESS",
"data": {
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"folder": "INBOX",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"has_attachments": false,
"size_bytes": 4821,
"is_read": false,
"is_starred": false,
"is_important": false,
"is_spam": false,
"snoozed_until": null,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}
}
]
}Champs de la réponse
messages[].message_uidL'id du message.
messages[].thread_idLa conversation à laquelle appartient le message.
messages[].folderLe dossier de cette entrée.
messages[].subject / previewObjet et court aperçu.
messages[].from_name / from_emailL'expéditeur.
messages[].has_attachments / size_bytesIndicateur de pièce jointe et taille du message.
messages[].is_read / is_starred / is_important / is_spamÉtat du message.
messages[].snoozed_untilDate d'échéance d'un message mis en attente, ou
null.messages[].received_atDate de réception du message.
has_more / next_cursorPagination.
Lister par libellé
Avec label, la commande lit l'index des libellés : seuls les messages libellés sont examinés. Chaque message est renvoyé avec son état actuel dans tous les dossiers, vous obtenez donc folders et labels au lieu d'un seul folder.
Données de réponse avec libellé
{
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"folders": [
"INBOX"
],
"labels": [
"cliente-vip"
],
"is_read": false,
"is_starred": false,
"is_important": false,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}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
INVALID_CURSORLe curseur est mal formé ou appartient à un autre compte ou dossier.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.