API

ลองใช้ในแซนด์บ็อกซ์ → ทุก endpoint มีปุ่มสำหรับเรียกใช้กับบริการจริง ทุกอย่างที่นี่ไม่ต้องใช้คีย์ ดังนั้นคำขอที่คุณส่งจากหน้านี้จึงเป็นคำขอจริง: คำขอนี้จะจองที่อยู่จริงและถูกนับรวม

ลำดับการทำงาน

คำขอสองครั้งและอีเมลหนึ่งฉบับ การเรียกครั้งที่สามมีไว้เพียงเพราะการวิเคราะห์ใช้เวลาสองสามวินาที

1. จองที่อยู่

   ส่ง POST ไปยัง endpoint ของกล่องจดหมาย คุณจะได้รับที่อยู่ที่รับข้อความได้เพียงหนึ่งฉบับและหมดอายุภายในหนึ่งชั่วโมง พร้อม slug ที่ใช้เป็นคีย์อ้างอิงสำหรับทุกอย่างที่เหลือ

2. ส่งข้อความจริงไปยังที่อยู่นั้น

   ส่งผ่าน SMTP จากแพลตฟอร์มที่จะใช้ส่งแคมเปญ การตรวจสอบครึ่งหนึ่งอ่านส่วนหัวที่แพลตฟอร์มส่งของคุณเพิ่มเข้ามา ดังนั้นข้อความที่เขียนขึ้นเองจึงวัดสิ่งที่ไม่ถูกต้อง

3. ตรวจสอบสถานะเป็นระยะ แล้วอ่านรายงาน

   endpoint สถานะมีขนาดไม่กี่ร้อยไบต์และแจ้งให้คุณทราบว่าควรดึงรายงานฉบับเต็มแล้วหรือยัง ตัวรายงานมีความยาวหลายพันบรรทัด

# 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 ที่ได้รับกลับมาคือสิทธิ์ในการเข้าถึง: ใครก็ตามที่ถือ slug นี้สามารถอ่านรายงานนั้นได้ และไม่มีใครอื่นเดา 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 ที่มีความสามารถเดียวกันและรองรับการรอแบบบล็อก ซึ่งดีกว่าการทำ polling จากภายในโมเดล
• For agents หน้าสำหรับเอเจนต์: ควรใช้สิ่งนี้เมื่อใด วิธีแยกแยะการตรวจสอบที่ถูกข้ามออกจากการตรวจสอบที่ผ่าน และผลการตรวจใดเป็นระเบียน DNS ที่บุคคลต้องแก้ไข ไม่ใช่ข้อความที่เอเจนต์แก้ไขได้