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.
https://g.sendcorex.com/v1command: searchSans 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.
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
querystringobligatoireCe 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.
fieldstringfacultatifLimite une recherche simple à
from,to,subject,body,senderoulabel. Ignoré quand la requête contient des opérateurs.limitnumberfacultatifTaille de page, de 1 à 100. Par défaut 25.
cursorstringfacultatifLe
next_cursorde 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 etreceived_at.has_more / next_cursorPagination.
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-subscribingou l'id d'un dossier personnalisé.has:attachmentUniquement les messages avec pièces jointes.
is:unread / is:read / is:starred / is:importantÉtat du message.
after: / before:Une date
YYYY/MM/DD(ouYYYY-MM-DD), UTC.newer_than: / older_than:7d,2w,3m(30 jours) ou1y.
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.
- 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.