Recevoir des e-mails : Lecture
Lister les fils
Listez les conversations d'un dossier, à la manière de Gmail, avec des filtres non lus, suivis, importants, pièces jointes et dates.
https://g.sendcorex.com/v1command: list_threadsChaque élément est une conversation. Ouvrez-la avec get_thread ou get_messages en utilisant son last_message_uid.
Arguments
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_readbooleanfacultatiffalsene renvoie que les conversations contenant un message non lu.is_starredbooleanfacultatifFiltre par étoile.
is_importantbooleanfacultatifFiltre par importance.
has_attachmentsbooleanfacultatifFiltre par pièces jointes.
afterstringfacultatifUniquement les conversations dont le dernier message date de ce jour ou après (inclus). RFC 3339,
YYYY-MM-DD(UTC) ou epoch en millisecondes.ex. :
"2026-10-01"beforestringfacultatifUniquement les conversations dont le dernier message est antérieur à cette date (exclue). Mêmes formats que
after.ex. :
"2026-10-08T00:00:00+08:00"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "list_threads",
args: {
folder: "INBOX",
is_read: false,
limit: 20
}
}
]
},
{ 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_threads",
"id": "0",
"type": "SUCCESS",
"data": {
"threads": [
{
"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",
"participants": [
"ana@client.com",
"you@yourdomain.com"
],
"last_senders": [
"ana@client.com"
],
"message_count": 2,
"thread_message_count": 3,
"unread_count": 1,
"has_unread": true,
"has_starred": false,
"has_important": false,
"has_attachments": false,
"last_message_uid": "Vj0xQUJDMTIz",
"last_message_at": "2026-10-09T14:21:07Z"
}
],
"has_more": true,
"next_cursor": "eyJwIjoyfQ"
}
}
]
}Champs de la réponse
threads[].thread_idL'id de la conversation.
threads[].folderLe dossier listé.
threads[].subjectObjet de la conversation.
threads[].previewCourt aperçu du dernier message.
threads[].from_name / from_emailExpéditeur du dernier message.
threads[].participantsTous les participants de la conversation.
threads[].last_sendersQui a écrit les derniers messages.
threads[].message_countMessages dans ce dossier.
threads[].thread_message_countMessages dans toute la conversation.
threads[].unread_count / has_unreadMessages non lus dans la conversation.
threads[].has_starred / has_important / has_attachmentsIndicateurs de la conversation.
threads[].last_message_uidL'id pour ouvrir la conversation avec
get_messagesouget_thread.threads[].last_message_atDate du dernier message.
has_more / next_cursorPagination. Envoyez
next_cursorcommecursorpour obtenir la page suivante.
Filtres et rapidité
is_read: false, is_starred: true et is_important: true utilisent leur propre index : seules les conversations correspondantes sont examinées, pas tout le dossier. Si vous les combinez, un seul index est utilisé (étoile, puis important, puis non lu) et le reste est filtré par-dessus. after et before sont des plages de clés : rien en dehors de la période n'est parcouru. has_attachments et les valeurs false d'étoile et d'important parcourent encore le dossier.
Conversations non lues sur une période
{
"commands": [
{
"command": "list_threads",
"args": {
"is_read": false,
"after": "2026-10-01",
"before": "2026-10-08T00:00:00+08:00"
}
}
]
}Pagination
Quand has_more vaut true, rappelez la commande avec cursor égal à next_cursor.
Node.js
let cursor;
const threads = [];
do {
const [result] = await call({
command: 'list_threads',
args: { folder: 'INBOX', limit: 100, ...(cursor ? { cursor } : {}) },
});
threads.push(...result.data.threads);
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);call est n'importe quel helper qui envoie { commands: [...] } en POST à /v1 et renvoie results, comme dans Run Commands.
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.