API

Спробувати в пісочниці → Кожна кінцева точка має кнопку, яка запускає її в реальному сервісі. Тут ключ не потрібен, тому запит, який ви надсилаєте з цієї сторінки, є справжнім: він резервує справжню адресу та враховується.

Цикл

Два запити й один лист. Третій виклик потрібен лише тому, що аналіз триває кілька секунд.

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

   Надішліть POST-запит до кінцевої точки inbox. У відповідь ви отримаєте адресу, яка приймає рівно один лист і втрачає чинність через годину, а також слаг, за яким визначається все інше.

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, що має змінити людина, а не текстом, який може редагувати агент.