Recevoir des e-mails : Lecture

Rechercher

Recherchez dans la boîte aux lettres par expéditeur, domaine, objet, corps ou libellé, avec les mêmes opérateurs que la barre de recherche du webmail.

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

Sans field, la recherche est automatique : une adresse e-mail complète recherche l'expéditeur exact, domain.com recherche par domaine, et tout le reste recherche dans l'objet, le corps et le nom de l'expéditeur.

i

Avec des opérateurs (from:, is:unread…), les résultats sont regroupés par conversation : une ligne par fil, avec le message le plus récent correspondant. Sans in:, Spam et Corbeille sont exclus.

Arguments

  • querystringobligatoire

    Ce qu'il faut rechercher, jusqu'à 256 caractères. Avec plusieurs mots, le premier vient de l'index et les autres filtrent sur l'objet et l'aperçu.

  • fieldstringfacultatif

    Limite une recherche simple à from, to, subject, body, sender ou label. Ignoré quand la requête contient des opérateurs.

  • limitnumberfacultatif

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

  • cursorstringfacultatif

    Le next_cursor de la page précédente.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "search",
        args: {
          query: "ana@client.com",
          field: "from",
          limit: 5
        }
      }
    ]
  },
  { 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": "search",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "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"
            ],
            "is_read": false,
            "is_starred": false,
            "is_important": false,
            "received_at": "2026-10-09T14:21:07Z"
          }
        ],
        "has_more": false,
        "next_cursor": null
      }
    }
  ]
}

Champs de la réponse

  • messages[]

    Messages correspondants, du plus récent au plus ancien. Chacun contient message_uid, thread_id, subject, preview, from_name, from_email, folders, les indicateurs lu/suivi/important et received_at.

  • has_more / next_cursor

    Pagination.

Opérateurs

Combinez-les avec des mots simples. Une valeur avec des espaces se met entre guillemets : subject:"new proposal". Ajoutez - devant pour exclure : -from:noreply, -newsletter.

Body de la requête

{
  "commands": [
    {
      "command": "search",
      "args": {
        "query": "from:ana@client.com has:attachment newer_than:30d invoice"
      }
    }
  ]
}
  • from: / to:

    Expéditeur / destinataire (to ou cc), une partie du nom ou de l'adresse.

  • subject: / label:

    Texte de l'objet / un libellé.

  • in:

    inbox, sent, archive, trash, spam, drafts, promotions, snoozed, scheduled, agents, not-subscribing ou l'id d'un dossier personnalisé.

  • has:attachment

    Uniquement les messages avec pièces jointes.

  • is:unread / is:read / is:starred / is:important

    État du message.

  • after: / before:

    Une date YYYY/MM/DD (ou YYYY-MM-DD), UTC.

  • newer_than: / older_than:

    7d, 2w, 3m (30 jours) ou 1y.

i

Des filtres seuls, sans mot à rechercher (is:unread in:archive), renvoient threads (la liste des conversations de ce dossier) au lieu de messages.

Exemples de recherche

Bodies de requête

// subject + body + sender name
{
  "commands": [
    {
      "command": "search",
      "args": {
        "query": "invoice september"
      }
    }
  ]
}

// exact sender
{
  "commands": [
    {
      "command": "search",
      "args": {
        "query": "ana@client.com",
        "field": "from"
      }
    }
  ]
}

// everyone from a domain
{
  "commands": [
    {
      "command": "search",
      "args": {
        "query": "client.com"
      }
    }
  ]
}

// messages with a label
{
  "commands": [
    {
      "command": "search",
      "args": {
        "query": "cliente-vip",
        "field": "label"
      }
    }
  ]
}

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.