ה-API

נסו בארגז החול → כל נקודת קצה, עם כפתור שמפעיל אותה מול השירות הפעיל. שום דבר כאן אינו דורש מפתח, ולכן בקשה שתשלחו מדף זה היא בקשה אמיתית: היא מקצה כתובת אמיתית והיא נספרת.

התהליך

שתי בקשות והודעת דוא״ל אחת. הקריאה השלישית קיימת רק מפני שהניתוח נמשך כמה שניות.

1. שריינו כתובת

   שלחו POST לנקודת הקצה של תיבת הדואר הנכנס. תקבלו בחזרה כתובת שמקבלת הודעה אחת בדיוק ותוקפה פג בתוך שעה, יחד עם המזהה הקצר שעליו מבוסס כל השאר.

2. שלחו אליה את ההודעה האמיתית

   דרך SMTP, מהפלטפורמה שתשלח את הקמפיין. מחצית מהבדיקות קוראות כותרות שפלטפורמת השליחה שלכם מוסיפה, ולכן הודעה שנכתבה ידנית מודדת את הדבר הלא נכון.

3. תשאלו את הסטטוס, ואז קראו את הדוח

   נקודת הקצה של הסטטוס מחזירה כמה מאות בתים ומציינת אם כבר כדאי לאחזר את הדוח המלא. הדוח עצמו משתרע על פני כמה אלפי שורות.

# 1. reserve a single-use address
curl -sX POST 'https://email-spam-tester.com/api/v1/inbox?lang=en'

{
  "address": "test-<slug>@t.email-spam-tester.com",
  "slug": "<slug>",
  "expires_at": "2026-01-01T12:00:00Z"
}

# 2. send your message to that address, then poll
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

{
  "slug": "<slug>",
  "analysis_status": "checks_ready",
  "ai_status": "running",
  "checks_done": 39,
  "checks_total": 39
}

# 3. read the report once analysis_status is checks_ready
curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>'

{
  "report_url": "https://email-spam-tester.com/t/<slug>",
  "score_ours": 86.4,
  "score_compat": 9.2,
  "subscores": {"auth": 100.0, "infra_spam": 78.1, "content": 92.0, "compliance": 75.0},
  "complete": true,
  "checks": [
    {
      "id": "auth.dmarc",
      "status": "warn",
      "title": "DMARC result",
      "summary": "DMARC passes, but the policy is p=none.",
      "weight_ours": -4.0,
      "evidence": {"policy": "none", "aligned": "dkim"},
      "citations": {"standards": [{"title": "RFC 9989 §4.7", "quote": "..."}]}
    }
  ],
  "fixes": [
    {"id": "dmarc-enforce", "gain_ours": 4.0, "gain_compat": 0.0,
     "fix": {"title": "Move DMARC to quarantine", "severity": "medium"}}
  ]
}

אימות

אין. אין מפתח לבקש, אין כותרת להגדיר, אין חשבון ליצור. ה-slug שמתקבל הוא ההרשאה: מי שמחזיק בו יכול לקרוא את הדוח, ואף אחד אחר אינו יכול לנחש אותו.

נקודות קצה

כתובת בסיס https://email-spam-tester.com. כל התשובות הן JSON.

קריאת הדוח

השדות שמכילים את התשובה, בסדר שבו סביר שתרצו אותם.

סטטוסים

לבדיקה יש אחד מחמישה מצבים, וההבדל בין שניים מהם חשוב יותר מכפי שנראה.

analysis_status עובר דרך received, analyzing, checks_ready, failed. ai_status עובר דרך pending, running, ready, fallback, error. הדוח הדטרמיניסטי סופי ב-checks_ready; ‏ai_status רק מוסיף את התוכנית.

מה יכול לחזור

ארבעה דברים שכדאי לדעת

למכונות

• /api/openapi.json תיאור OpenAPI, שנוצר מאותו קוד שמפעיל את ה-API.
• /llms.txt, /llms-full.txt מפה קצרה של האתר הזה עבור מודלי שפה, לפי מוסכמת llms.txt, וגרסה ארוכה יותר עם כל הלולאה ושדות הדוח בקובץ אחד.
• /mcp שרת MCP עם אותה יכולת והמתנה חוסמת, שעדיפה על תשאול חוזר מתוך מודל.
• For agents דף הסוכן: מתי להשתמש בזה, איך להבין בדיקה שדולגה לעומת בדיקה שעברה, ואילו ממצאים הם רשומות DNS שאדם צריך לשנות ולא טקסט שסוכן יכול לערוך.