Recevoir des e-mails : Brouillons

Lister les brouillons

Listez les brouillons de la boîte aux lettres, du plus récent au plus ancien. Même résultat que list_messages sur le dossier Drafts.

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

Les brouillons enregistrés dans le webmail apparaissent aussi ici. Utilisez get_draft pour en lire un avec son corps et ses pièces jointes.

Arguments

  • limitnumberfacultatif

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

  • cursorstringfacultatif

    Le next_cursor de la page précédente.

  • afterstringfacultatif

    Uniquement les brouillons enregistrés après cette heure (RFC 3339, YYYY-MM-DD ou epoch ms).

  • beforestringfacultatif

    Uniquement les brouillons enregistrés avant cette heure.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "list_drafts",
        args: {
          limit: 25
        }
      }
    ]
  },
  { 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_drafts",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "messages": [
          {
            "message_uid": "Vj0xRFJBRlQx",
            "thread_id": "thr_9a1c4e72",
            "folder": "Drafts",
            "subject": "Proposal",
            "preview": "Hi Ana, here is the proposal.",
            "from_name": "Marcos",
            "from_email": "marcos@yourdomain.com",
            "has_attachments": true,
            "size_bytes": 2210,
            "is_read": true,
            "is_starred": false,
            "is_important": false,
            "is_spam": false,
            "snoozed_until": null,
            "received_at": "2026-10-27T02:10:00Z"
          }
        ],
        "has_more": false,
        "next_cursor": null
      }
    }
  ]
}

Champs de la réponse

  • messages[].message_uid

    Le draft_id.

  • messages[].received_at

    Date du dernier enregistrement du brouillon.

  • has_more / next_cursor

    Envoyez next_cursor comme cursor pour obtenir la page suivante.

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.