API документация

Бесплатный JSON API. Базовый URL: https://3check.ru/api. Метод GET. Лимит 30 запросов/день на IP. Ключ не требуется.

Все ответы содержат ok: true|false. При ошибке — error с описанием.

Формат запроса

GET https://3check.ru/api?action=<действие>&domain=<домен>

Действия

action=full — полная проверка

Сводный отчёт: балл здоровья 0–100, приоритизированный список проблем, все секции.

curl "https://3check.ru/api?action=full&domain=example.ru"

action=mail — почтовая диагностика

MX, SPF (рекурсивное дерево), DKIM (автопоиск селекторов), DMARC, MTA-STS, TLS-RPT, BIMI.

Опционально: &selector= — конкретный DKIM-селектор.

curl "https://3check.ru/api?action=mail&domain=example.ru"

action=dns — DNS-записи

A, AAAA, MX, TXT, NS, CNAME, SOA с TTL.

action=blacklist — чёрные списки

Проверка IP или домена по 39 DNSBL. Принимает domain= как домен или IP.

action=ssl — SSL-сертификат

Сроки, цепочка, соответствие домену, протокол. Порт: &port=8443.

action=smtp — SMTP-тест

Соединение с MX, EHLO, STARTTLS, reverse DNS.

action=whois — WHOIS

Регистратор, даты, статус, NS. Прямой TCP:43.

action=http — HTTP-заголовки

Цепочка редиректов + заголовки безопасности. Схема: &scheme=http.

action=port — проверка портов

18 типовых портов или свой список: &ports=80,443,8080.

action=myip — информация об IP клиента

IP, PTR, ASN, провайдер, страна, признаки прокси. Без лимита.

action=generate — генератор записей

SPF: &kind=spf&providers=yandex,google&strict=1

DMARC: &kind=dmarc&domain=x.ru&policy=quarantine&rua=mail@x.ru

Пример ответа (full)

{
  "ok": true,
  "domain": "example.ru",
  "score": 89,
  "grade": "хорошо",
  "issues": [
    {"severity": "warning", "title": "SPF без ~all/-all", "fix": "..."}
  ],
  "sections": { "mx": [...], "spf": {...}, "ssl": {...} }
}

Нужен лимит выше 30/день или мониторинг? Подключите мониторинг или напишите нам.