API

Thử trong sandbox → Mọi endpoint đều có một nút để chạy endpoint đó trên dịch vụ trực tiếp. Không có thao tác nào ở đây cần khóa, vì vậy yêu cầu bạn gửi từ trang này là yêu cầu thực: yêu cầu đó giữ chỗ một địa chỉ thực và được tính.

Quy trình

Hai yêu cầu và một email. Lệnh gọi thứ ba chỉ cần thiết vì quá trình phân tích mất vài giây.

1. Đặt trước một địa chỉ

   Gửi POST đến endpoint hộp thư đến. Bạn nhận lại một địa chỉ chỉ chấp nhận đúng một thư và hết hạn sau một giờ, cùng với slug dùng để định danh mọi thứ còn lại.

2. Gửi thư thực tế đến địa chỉ đó

   Qua SMTP, từ nền tảng sẽ gửi chiến dịch. Một nửa số lượt kiểm tra đọc các header do nền tảng gửi của bạn thêm vào, vì vậy thư được soạn thủ công sẽ đo không đúng đối tượng.

3. Polling trạng thái, sau đó đọc báo cáo

   Endpoint trạng thái chỉ có kích thước vài trăm byte và cho bạn biết liệu đã nên tải báo cáo đầy đủ hay chưa. Bản thân báo cáo dài đến vài nghìn dòng.

# 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"}}
  ]
}

Xác thực

Không có. Không cần yêu cầu khóa, không cần thiết lập header, không cần tạo tài khoản. Slug bạn nhận được chính là quyền truy cập: bất kỳ ai nắm giữ nó đều có thể đọc báo cáo đó, và không ai khác có thể đoán được nó.

Endpoint

Địa chỉ cơ sở https://email-spam-tester.com. Mọi phản hồi đều ở dạng JSON.

Đọc báo cáo

Các trường chứa kết quả, theo thứ tự mà bạn có thể cần đến.

Trạng thái

Một lượt kiểm tra có một trong năm trạng thái, và sự khác biệt giữa hai trạng thái trong số đó quan trọng hơn vẻ bề ngoài.

analysis_status lần lượt là received, analyzing, checks_ready, failed. ai_status lần lượt là pending, running, ready, fallback, error. Báo cáo xác định là báo cáo cuối cùng tại checks_ready; ai_status chỉ bổ sung kế hoạch.

Những gì có thể được trả về

Bốn điều cần biết

Dành cho máy

• /api/openapi.json Mô tả OpenAPI, được tạo từ cùng mã nguồn phục vụ API.
• /llms.txt, /llms-full.txt Bản đồ ngắn của trang web này dành cho các mô hình ngôn ngữ, theo quy ước llms.txt, và một phiên bản dài hơn chứa toàn bộ quy trình cùng các trường báo cáo trong một tệp.
• /mcp Máy chủ MCP có cùng khả năng và cơ chế chờ chặn, hiệu quả hơn việc thăm dò từ bên trong một mô hình.
• For agents Trang dành cho tác nhân: khi nào nên dùng công cụ này, cách phân biệt một bước kiểm tra bị bỏ qua với một bước kiểm tra đạt, và những phát hiện nào là bản ghi DNS mà con người phải thay đổi thay vì văn bản mà tác nhân có thể chỉnh sửa.