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.

POSThttps://g.sendcorex.com/v1command: list_threads
i

Chaque élément est une conversation. Ouvrez-la avec get_thread ou get_messages en utilisant son last_message_uid.

Arguments

  • folderstringfacultatif

    Dossier à lister. Par défaut INBOX.

  • limitnumberfacultatif

    Taille de page, de 1 à 100. Par défaut 25.

  • cursorstringfacultatif

    Le next_cursor de la page précédente.

  • is_readbooleanfacultatif

    false ne renvoie que les conversations contenant un message non lu.

  • is_starredbooleanfacultatif

    Filtre par étoile.

  • is_importantbooleanfacultatif

    Filtre par importance.

  • has_attachmentsbooleanfacultatif

    Filtre par pièces jointes.

  • afterstringfacultatif

    Uniquement 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"

  • beforestringfacultatif

    Uniquement 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_id

    L'id de la conversation.

  • threads[].folder

    Le dossier listé.

  • threads[].subject

    Objet de la conversation.

  • threads[].preview

    Court aperçu du dernier message.

  • threads[].from_name / from_email

    Expéditeur du dernier message.

  • threads[].participants

    Tous les participants de la conversation.

  • threads[].last_senders

    Qui a écrit les derniers messages.

  • threads[].message_count

    Messages dans ce dossier.

  • threads[].thread_message_count

    Messages dans toute la conversation.

  • threads[].unread_count / has_unread

    Messages non lus dans la conversation.

  • threads[].has_starred / has_important / has_attachments

    Indicateurs de la conversation.

  • threads[].last_message_uid

    L'id pour ouvrir la conversation avec get_messages ou get_thread.

  • threads[].last_message_at

    Date du dernier message.

  • has_more / next_cursor

    Pagination. Envoyez next_cursor comme cursor pour 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);
i

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.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus 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.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDINVALID_CURSOR

    Le curseur est mal formé ou appartient à un autre compte ou dossier.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.