API

Попробовать в песочнице → Каждая конечная точка снабжена кнопкой, которая запускает запрос к рабочему сервису. Здесь нигде не нужен ключ, поэтому запрос, отправленный с этой страницы, является реальным: он резервирует реальный адрес и учитывается.

Цикл

Два запроса и одно письмо. Третий вызов нужен только потому, что анализ занимает несколько секунд.

1. Зарезервируйте адрес

   Отправьте POST-запрос к конечной точке входящих сообщений. В ответ вы получите адрес, который принимает ровно одно сообщение и истекает через час, а также slug, к которому привязано всё остальное.

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

Аутентификация

Её нет. Не нужно запрашивать ключ, задавать заголовок или создавать учётную запись. Полученный слаг и есть средство доступа: любой, у кого он есть, может прочитать этот отчёт, а остальные не могут его угадать.

Конечные точки

Базовый адрес 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, которые должен изменить человек, а не к тексту, который может отредактировать агент.