E-Mails empfangen: Regeln
Regel testen
Sehen Sie, wie viele der letzten E-Mails eines Ordners eine Regel erfassen würde, bevor Sie sie speichern oder einschalten.
https://g.sendcorex.com/v1command: test_ruleGetestet werden Betreff, Absender, Empfänger und Vorschau der gespeicherten E-Mails. body- und header-Bedingungen werden erst beim Eingang einer neuen E-Mail vollständig geprüft.
Argumente
idstringoptionalEine gespeicherte Regel (funktioniert auch, wenn sie ausgeschaltet ist).
ruleobjectoptionalOder eine nicht gespeicherte Regel, im gleichen Format wie bei Regel erstellen.
folderstringoptionalStandard ist INBOX.
limitnumberoptionalWie viele der letzten E-Mails geprüft werden, 1 bis 500. Standard ist 200.
Schnellstart
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);Antwort
{
"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"
]
}
}
}
]
}Antwortfelder
matchedWie viele der durchsuchten E-Mails zutreffen.
examplesBis zu 10 davon.
would_doWas die Regel bei einem Treffer tut.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
TOKEN_EXPIREDDer Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.
- 401
INVALID_TOKENDer Token ist fehlerhaft, unbekannt oder widerrufen.
- 429
RATE_LIMITEDMehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.
- CMD
INVALID_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
INVALID_RULEDie Regel ist ungültig. Die Meldung nennt die Bedingung oder Aktion und den Grund.
- CMD
NOT_FOUNDDie Nachricht, die Konversation oder der Ordner existiert für diesen Token nicht.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.