Provar una regla
Quins dels teus missatges recents hauria capturat aquesta regla. No canvia res.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
POST /rules/{id}/test
Quins dels teus missatges recents hauria capturat aquesta regla. No canvia res.
Exemple
Necessita rules:read. Una prova en sec llegeix una bústia i no escriu res, de manera que no és una operació de rules:write. days és 30 per defecte i arriba a 365, limit és 50 per defecte i arriba a 200, i threadIds prova fils concrets en lloc d'una finestra.
curl -X POST "$OE/rules/rul_7f3a1c94e05d3862c1f0a44b/test" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "days": 30, "limit": 50 }'{ "object": "rule_test", "ruleId": "rul_7f3a1c94e05d3862c1f0a44b", "scanned": 50, "matched": 3, "wouldApply": ["label:USER_RECEIPTS", "archive"], "messages": [ { "threadId": "thr_5d31c2a8…", "from": "[email protected]", "subject": "Your receipt", "receivedAt": "2026-08-28T10:00:00.000Z" } ], "warnings": [{ "code": "forward_unverified", "value": "[email protected]" }]}Qui respon és el mateix motor que s'executa al camí de lliurament. És un únic mòdul, deliberadament pur (sense base de dades ni xarxa), de manera que la pantalla de configuració, la prova en sec i el gestor SMTP no poden discrepar sobre si una regla coincideix. Una previsualització escrita dues vegades són dues respostes a una sola pregunta, i la que es mostra a una persona és la que està malament.
Acotat per construcció: com a màxim 200 missatges i com a màxim un any. Això s'executa dins d'un Worker amb un pressupost de temps real, i una exploració sense límits és una petició que mor a mig camí sense res a mostrar.
Una regla desactivada també es pot provar. Aquesta és la idea: escriu-la, prova-la i després activa-la.
warnings és on apareix una regla que s'analitza correctament però que no es comportarà bé. L'adreça de reenviament que ningú no ha confirmat és la que et trobaràs. Un avís no atura mai la prova: la gràcia d'una prova en sec és informar de tot el que ha trobat en una sola passada en lloc d'aturar-se a la primera cosa.
No hi ha cap «executa-ho sobre la meva bústia»
Deliberadament no hi ha cap POST /rules/{id}/run, i no n'hi haurà cap. Aplicar una regla retroactivament a tota una bústia no té límits, és irreversible i no es pot desfer (una acció trash sobre deu anys de correu és una sola crida sense segona oportunitat), i el camí d'escriptura que hauria d'utilitzar es fusiona amb el fil desat, cosa que faria pujar al capdamunt de la safata d'entrada tots els missatges que toqués com a efecte secundari de fer neteja.
Aquest endpoint és la meitat honesta d'aquella petició: respon «què hauria fet això», que és la pregunta, i després arxives els missatges que realment volies amb PATCH /threads/{id}.