Recevoir des e-mails : Règles
Tester une règle
Voyez combien d'e-mails récents d'un dossier une règle intercepterait avant de l'enregistrer ou de l'activer.
https://g.sendcorex.com/v1command: test_ruleTesté sur l'objet, l'expéditeur, les destinataires et l'aperçu des e-mails stockés. Les conditions body et header ne sont entièrement vérifiées qu'à l'arrivée d'un nouvel e-mail.
Arguments
idstringfacultatifUne règle enregistrée (fonctionne aussi si elle est désactivée).
ruleobjectfacultatifOu une règle non enregistrée, au même format que Créer une règle.
folderstringfacultatifPar défaut INBOX.
limitnumberfacultatifNombre d'e-mails récents à vérifier, de 1 à 500. Par défaut 200.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "test_rule",
args: {
rule: {
name: "Invoices",
conditions: [
{
field: "subject",
op: "contains",
value: "invoice"
}
],
actions: [
{
type: "label",
value: "Finance"
}
]
},
folder: "INBOX"
}
}
]
},
{ 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": "test_rule",
"id": "0",
"type": "SUCCESS",
"data": {
"folder": "INBOX",
"scanned": 200,
"matched": 12,
"examples": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice #123",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"received_at": "2026-10-24T03:10:00Z"
}
],
"would_do": {
"folder": "",
"labels": [
"Finance"
],
"matched": [
"Invoices"
]
}
}
}
]
}Champs de la réponse
matchedNombre d'e-mails analysés qui correspondent.
examplesJusqu'à 10 d'entre eux.
would_doCe que fait la règle quand elle correspond.
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_RULELa règle n'est pas valide. Le message indique quelle condition ou action, et pourquoi.
- CMD
NOT_FOUNDLe message, la conversation ou le dossier n'existe pas pour ce token.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.