Kiểm thử quy tắc
Những thư gần đây nào quy tắc này lẽ ra đã bắt được. Nó không thay đổi gì.
Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.
POST /rules/{id}/test
Những thư gần đây nào quy tắc này lẽ ra đã bắt được. Nó không thay đổi gì.
Ví dụ
Cần rules:read. Một lần chạy thử đọc hộp thư và không ghi gì, nên đây không phải là thao tác rules:write. days mặc định là 30 và tối đa 365, limit mặc định là 50 và tối đa 200, và threadIds kiểm thử các luồng thư được chỉ định thay vì một khoảng thời gian.
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]" }]}Chính engine chạy trên đường nhận thư trả lời điều này. Đó là một module, được giữ thuần túy có chủ đích (không cơ sở dữ liệu, không mạng), nên màn hình cài đặt, lần chạy thử và trình xử lý SMTP không thể bất đồng về việc một quy tắc có khớp hay không. Một bản xem trước được viết hai lần là hai câu trả lời cho một câu hỏi, và câu trả lời được hiển thị cho người dùng lại là câu sai.
Được giới hạn theo thiết kế: tối đa 200 thư trong tối đa một năm. Lệnh này chạy bên trong một Worker với ngân sách thời gian thực, và một lần quét không giới hạn là một yêu cầu chết giữa chừng mà không có kết quả gì.
Quy tắc đang tắt vẫn có thể được kiểm thử. Đó chính là mục đích: viết, kiểm thử, rồi bật.
warnings là nơi hiển thị một quy tắc phân tích cú pháp được nhưng sẽ không hoạt động như mong đợi. Địa chỉ chuyển tiếp chưa ai xác nhận là trường hợp bạn sẽ gặp. Cảnh báo không bao giờ dừng lần kiểm thử: mục đích của lần chạy thử là báo cáo mọi thứ nó tìm thấy trong một lượt thay vì thất bại ở điều đầu tiên.
Không có “chạy quy tắc này trên hộp thư của tôi”
Có chủ đích không có POST /rules/{id}/run, và sẽ không bao giờ có. Áp dụng quy tắc hồi tố cho cả hộp thư là không giới hạn, không thể đảo ngược và không có hoàn tác (một hành động trash trên mười năm thư là một lệnh gọi không có cơ hội thứ hai), và đường ghi mà nó phải dùng sẽ hợp nhất vào luồng thư đã lưu, khiến mọi thư nó chạm vào bị đẩy lên đầu hộp thư đến như một tác dụng phụ của việc dọn dẹp.
Endpoint này là nửa trung thực của yêu cầu đó: nó trả lời "quy tắc này lẽ ra đã làm gì", vốn là câu hỏi thực sự, và sau đó bạn tự phân loại các thư bạn thực sự muốn bằng PATCH /threads/{id}.