API проверки писем на спам,
папки и домена

Быстрый старт

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

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

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

   Запрос

   # 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. Отправьте на него настоящее сообщение

   По SMTP, с платформы, которая будет отправлять рассылку. Половина проверок анализирует заголовки, добавляемые вашей платформой отправки, поэтому составленное вручную сообщение измеряет не то, что нужно.

   Запрос

   # 2. send your message to that address, from your own platform
   To: test-<slug>@t.email-spam-tester.com

3. Опрашивайте статус, затем прочитайте отчёт

   Конечная точка статуса возвращает несколько сотен байт и сообщает, стоит ли уже загружать полный отчёт. Сам отчёт занимает несколько тысяч строк.

   Запрос

   # 3. poll
   curl -s 'https://email-spam-tester.com/api/v1/tests/<slug>/status'

   Ответ

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

   Запрос

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

Зарезервируйте адрес, отправьте сообщение, которое вы собирались отправить своему списку рассылки, и прочитайте отчёт. Всё, что показано на странице, есть в JSON, включая оценку, все 42 проверки с подтверждающими данными и раздел стандарта, на котором основан каждый результат.

Первые 100 000 отчётов бесплатны, без ключа и без учётной записи. Если вы подключаете агент, а не скрипт, сервер MCP подходит лучше, чем опрос.

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

Базовый адрес https://email-spam-tester.com. Все ответы возвращаются в формате JSON.

Быстрый старт

1. Создайте тест

   Отправьте POST-запрос к конечной точке placement. В ответ вы получите маркер и тестовые почтовые ящики.

   Запрос

   # 1. create a test
   curl -sX POST 'https://email-spam-tester.com/api/v1/placement' \
     -H 'Content-Type: application/json' \
     -d '{"public_results_accepted":true}'

   Ответ

   {
     "slug": "<slug>",
     "marker": "est-3f9a1c7e2b4d6a80c5e1f2d3",
     "status": "waiting",
     "deadline": "2026-10-31T12:30:00Z",
     "poll_after_seconds": 60,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "pending", "observed_at": null}
     ],
     "fleet": {
       "status": "observing",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "pending", "coverage": "pending"}
       ]
     }
   }

2. Отправьте одно сообщение в каждый ящик

   Поместите маркер в тему и отправьте сообщение со своей обычной платформы сразу на все адреса.

   Запрос

   # 2. one message to every address, with the marker in the subject
   Subject: October invoice est-3f9a1c7e2b4d6a80c5e1f2d3
   To: <seed>, <mailbox>, ...

3. Опрашивайте данные о папках

   Для каждого адреса заполняются данные о провайдере и папке. Выполняйте опрос, пока статус не перестанет быть waiting.

   Запрос

   # 3. poll for the folders
   curl -s 'https://email-spam-tester.com/api/v1/placement/<slug>'

   Ответ

   {
     "status": "complete",
     "received": 2,
     "total": 2,
     "results": [
       {"address": "<seed>", "provider": "gmail", "kind": "Gmail",
        "placement": "primary", "observed_at": "2026-10-31T12:04:11Z"},
       {"address": "<seed>", "provider": "gmail", "kind": "Google Workspace",
        "placement": "promotions", "observed_at": "2026-10-31T12:04:11Z"}
     ],
     "fleet": {
       "status": "finished",
       "results": [
         {"address": "<mailbox>", "provider": "yahoo", "available": true,
          "placement": "inbox", "coverage": "ok"},
         {"address": "<mailbox>", "provider": "outlook", "available": true,
          "placement": "spam", "coverage": "ok"}
       ]
     }
   }

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

Быстрый старт

1. Выполните один GET-запрос

   Передайте домен. ip добавляет ваши адреса отправки, а selector задает селекторы DKIM для чтения.

   Запрос

   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true'

2. Прочитайте результат

   ok служит ответом для скрипта, а sections показывает, какая часть завершилась с ошибкой.

   Ответ

   {
     "id": "ir_01JB8Y4T2M6K9QZ7H3V5N1XWDA",
     "domain": "example.com",
     "checked_at": "2026-10-31T12:00:00Z",
     "ok": false,
     "status": "fail",
     "score": 78,
     "coverage": {"answered": 7, "total": 8},
     "ips": [{"ip": "203.0.113.5", "sources": ["mx", "spf"], "managed": false}],
     "sections": {
       "dkim": {"status": "pass", "core": true, "findings": [], "data": {}},
       "ptr": {"status": "fail", "core": true, "findings": [], "data": {}}
     },
     "not_checked": [
       {"check": "dkim_signature", "reason": "needs_a_message"},
       {"check": "alignment", "reason": "needs_a_message"}
     ],
     "diff": {
       "baseline": {"id": "ir_01JB2...", "checked_at": "2026-10-24T12:00:00Z"},
       "first_run": false,
       "changed": true,
       "worsened": true,
       "status_from": "pass",
       "score_from": 100,
       "changes": [
         {"path": "dkim.key.mail.sha256", "section": "dkim", "kind": "removed",
          "severity": "critical", "effect": "worsened", "from": "9f2c...", "to": null}
       ],
       "not_compared": [
         {"path": "blocklist_ip.203.0.113.5.bl.spamcop.net.listed", "reason": "lookup_failed"}
       ]
     }
   }

3. Добавьте в cron

   С diff=true каждый запуск сравнивается с предыдущим, а jq преобразует ответ в код завершения.

   Запрос

   # exits non-zero if the domain is broken or its setup changed
   curl -s 'https://email-spam-tester.com/api/v1/infra/check?domain=example.com&selector=mail&diff=true' \
     | jq -e '.ok and (.diff.changed | not)'

Чтение ответа

Завершённая проверка возвращает 200, а вердикт находится в теле ответа. status соответствует худшему результату обязательных разделов: spf, dkim, dmarc, ptr, blocklist_ip, blocklist_domain, mx и smtp. unknown в обязательном разделе считается warn. ok имеет значение true, когда status равен pass или warn. score принимает значения от 0 до 100 по обязательным разделам, которые вернули ответ, и равен null, когда из-за ошибок и unknown остаётся менее половины применимого веса. mta_sts, tls_rpt, bimi, dnssec, dane, ns и registration включаются в отчёт и сравниваются, но не влияют на ok или score.

Раздел может иметь статус pass, warn, fail, error (мы не смогли выполнить проверку), unknown (недостаточно данных) или skipped (не применимо). skipped не влияет на результат, а причина указывается в not_checked. dkim_signature и alignment присутствуют всегда, поскольку для них требуется реальное сообщение.

Что меняют ip и selector

PTR и списки блокировок относятся к адресам, поэтому для запуска нужны адреса. Используются переданные вами значения ip. Если их нет, берётся до четырёх адресов с ваших MX-хостов и из терминов ip4: и ip6: с одним адресом в корневой записи SPF. Адреса известного почтового провайдера помечаются как managed и не проверяются, а если после этого адресов не остаётся, ptr и blocklist_ip возвращают skipped. selector нельзя получить из DNS, поэтому при запуске проверяются переданный вами selector, значения, найденные вашими предыдущими запусками, и список распространённых имён. Если ничего не найдено, это ничего не доказывает, и dkim возвращает unknown. Если вы отправляете почту со своего сервера, передайте оба параметра.

Что изменилось

Каждая запись в diff.changes содержит path, kind (added, removed, changed), severity (critical, warning, info) и effect (worsened, improved, neutral). Только critical и warning устанавливают diff.changed, поэтому ротация ключа DKIM на ключ той же длины, новый адрес MX или обновлённый сертификат не поднимают тревогу в cron. diff.worsened следует значению effect любого изменения. При первом запуске сравнивать не с чем, и diff.first_run указывает на это.

Базовой линией всегда служит один из ваших запусков, поэтому проверка домена кем-то другим между двумя вашими запусками ничего не скрывает. Всё, что нам не удалось прочитать в этот раз, попадает в diff.not_compared с сохранением последнего известного значения, а значит, изменение, внесённое во время сбоя, появится, как только запрос снова станет выполняться. Запуск с другим ip или selector остаётся в той же серии, а то, что он не запрашивал, также не сравнивается.

Почему для запланированной проверки следует использовать ключ

Без ключа ваша история привязана к хешу вашего IP-адреса с ключом, поэтому она заканчивается при изменении адреса, а пользователи с одним адресом используют её совместно: запуск коллеги смещает вашу базовую линию. При использовании персонального API-ключа в Authorization: Bearer история привязывается к ключу. Запуски с ключом хранятся 365 дней и доступны только с этим ключом. Запуски без ключа хранятся 30 дней и доступны любому, у кого есть их id.

6 запросов в минуту и 50 в день на IP либо 30 и 500 на ключ. При превышении лимита возвращается ответ 429 с Retry-After. Идентичный запрос в течение 60 секунд обслуживается из кеша, помечается как cached: true, не создаёт запись о запуске и не учитывается. Для чтения сохранённых запусков разрешено 120 запросов в минуту на клиента. Ответ 503 с Retry-After означает, что выполняется слишком много проверок, или, при чтении сохранённых запусков, что хранилище недоступно. 401 означает неверный ключ. Ответ 422 содержит detail.code: invalid_domain, invalid_ip, invalid_selector, invalid_check, invalid_since, unknown_baseline или account_required.

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

Быстрый старт

1. Выберите проверку

   Выберите инструмент из списка ниже и передайте домен, адрес или IP, который он запрашивает.

   Запрос

   curl -s 'https://email-spam-tester.com/api/v1/tools/spf?domain=example.com'

2. Проверьте статус и результаты

   Каждый инструмент возвращает статус и результаты. Последующие поля зависят от инструмента.

   Ответ

   {
     "tool": "spf",
     "query": {"domain": "example.com"},
     "checked_at": "2026-10-31T12:00:00Z",
     "duration_ms": 412,
     "status": "fail",
     "findings": [
       {"code": "spf.too_many_lookups", "level": "fail",
        "params": {"limit": 10, "count": 12},
        "message": "RFC 7208 §4.6.4 allows at most 10 DNS lookups, and this record needs 12, so receivers return permerror."}
     ],
     "record": "v=spf1 include:_spf.example.net ~all",
     "lookups": {"count": 12, "limit": 10, "void": 0}
   }

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