# REST инструментов Mailganer

> Публичный REST self-service тулов Mailganer. Этот хост — справочник для агентов и разработчиков: Auth, OpenAPI/Swagger и каталог. Вызовы API — на mailganer.com, не здесь. HTML живых страниц `/tools/*` для известных ИИ-краулеров закрыт (403). Карту REST брать отсюда. Валидация как продукт — https://mailganer.com/features/validacija-bazy и тариф https://mailganer.com/price/validation; `POST /tools/validation/v1` — экспресс для людей, квоту ботам не жечь.

Канон URL: **без** `/ru/` и **без** trailing slash. Публичный REST: `https://mailganer.com/tools/{slug}/v1` (не `/wp-json`).

## Как подключить

- База: `https://mailganer.com/tools/{slug}/v1`. JSON, `Content-Type: application/json`.
- Сначала `GET {base}/status` — квота, капча, готовность ключа. Исключение: SMTP Diag — `GET https://mailganer.com/tools/smtp-diag/health`.
- Демо в браузере: Яндекс SmartCaptcha. Токен в `smart-token`, `captchaToken` или `X-Captcha-Token`.
- Интеграция: `Authorization: Bearer <key>` (у части методов также `X-Api-Key`).
- Служебные токены (`X-MG-Service-Token`, `X-Countdown-Token`, `X-Internal-Token`) — только по договорённости, не через публичную заявку.
- MX Router — исключение: база `https://mx.samotpravil.ru/api/v2/mx`, заголовок `Authorization` (ключ сырой или `Bearer`).
- Не вызывай API на `tools.mailganer.com` — будет 301 на канон. Здесь только справочник.
- OpenAPI JSON: `https://tools.mailganer.com/openapi/{slug}.json`. HTML-хаб со Swagger: https://tools.mailganer.com/
- Auth для людей и агентов: https://tools.mailganer.com/#auth

## Как получить Bearer-ключ

- Self-service выдачи нет. Ключ выдаёт поддержка Mailganer после проверки заявки.
- Напишите на `support@mailganer.ru` (тема: `API-ключ tools Mailganer`).
- В письме: компания, контакт, нужные тулы (slug), сценарий, ожидаемый объём запросов в сутки.
- Шаблон письма и условия бесплатного ключа (attribution / paid): https://tools.mailganer.com/#auth

## Каталог

### Авторизация

- [Email OTP](https://tools.mailganer.com/email-otp): Verify API: отправили код на email с бэкенда и проверили ответ. REST `https://mailganer.com/tools/email-otp/v1`. 4 метода. доступ: опционально Bearer; капча или Authorization: Bearer; только Bearer. OpenAPI https://tools.mailganer.com/openapi/email-otp.json. UI https://mailganer.com/tools/email-otp

### Доставляемость

- [Репутация](https://tools.mailganer.com/ip-reputation): IP, домен или DNS-пул: DNSBL, рейтинг IP, PTR и FCrDNS в одном инструменте. REST `https://mailganer.com/tools/ip-reputation/ip/v1`. 16 методов. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/ip-reputation.json. UI https://mailganer.com/tools/ip-reputation/ip
- [Анализатор DMARC](https://tools.mailganer.com/dmarc): Подключите ящик с rua-отчётами — сводка pass/fail и источники IP за 30 дней. REST `https://mailganer.com/tools/dmarc/v1`. 7 методов. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/dmarc.json. UI https://mailganer.com/tools/dmarc
- [Проверка Inbox](https://tools.mailganer.com/inbox-checker): Куда попало письмо: Inbox или Spam у Яндекса и diagnostic-ящика, SPF/DKIM live. REST `https://mailganer.com/tools/inbox-checker/v1`. 12 методов. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/inbox-checker.json. UI https://mailganer.com/tools/inbox-checker
- [Тестер bounce](https://tools.mailganer.com/bounce-tester): SMTP reject, DSN и soft на MX bounce-tester — приёмка сендера. REST `https://mailganer.com/tools/bounce-tester/v1`. 2 метода. доступ: без ключа; демо — SmartCaptcha. OpenAPI https://tools.mailganer.com/openapi/bounce-tester.json. UI https://mailganer.com/tools/bounce-tester
- [SMTP-диагностика](https://tools.mailganer.com/smtp-diag): Временный SMTP blackhole: полный диалог, fault injection и разбор сессии. REST `https://mailganer.com/tools/smtp-diag/v1`. 6 методов. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/smtp-diag.json. UI https://mailganer.com/tools/smtp-diag
- [Риск домена](https://tools.mailganer.com/domain-risk): Preflight перед SMTP: DNS, SPF/DKIM/DMARC и репутация — можно ли принимать домен. REST `https://mailganer.com/tools/domain-risk/v1`. 6 методов. доступ: капча или X-MG-Service-Token; X-MG-Service-Token, allow-лист IP. OpenAPI https://tools.mailganer.com/openapi/domain-risk.json. UI https://mailganer.com/tools/domain-risk
- [MX Router](https://tools.mailganer.com/mx-router): Домен на MX SaM: приём писем, поиск по API и webhook о новой почте. REST `https://mx.samotpravil.ru/api/v2/mx`. 11 методов. доступ: Authorization: ключ (сырой или Bearer). OpenAPI https://tools.mailganer.com/openapi/mx-router.json. UI https://mailganer.com/tools/mx-router

### DNS-записи

- [Проверка DNS-авторизации](https://tools.mailganer.com/dns-auth): SPF, DKIM, DMARC, BIMI/VMC разом — полный отчёт и подсказки. REST `https://mailganer.com/tools/dns-auth/v1`. 6 методов. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/dns-auth.json. UI https://mailganer.com/tools/dns-auth
- [Рейтинг SPF](https://tools.mailganer.com/spf-score): Кто в include: класс ESP A–D и список сервисов рассылок. REST `https://mailganer.com/tools/spf-score/v1`. 5 методов. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/spf-score.json. UI https://mailganer.com/tools/spf-score

### Тест письма

- [Тест письма (Mail Tester)](https://tools.mailganer.com/mail-tester): Спам-балл, auth, нативная отписка, превью HTML/AMP. REST `https://mailganer.com/tools/mail-tester/v1`. 14 методов. доступ: опционально Bearer партнёра; капча или Authorization: Bearer; капча. OpenAPI https://tools.mailganer.com/openapi/mail-tester.json. UI https://mailganer.com/tools/mail-tester
- [AI-анализ HTML](https://tools.mailganer.com/html-analyzer): Орфография, тёмная тема, UTM, вёрстка и ссылки — разбор HTML письма. REST `https://mailganer.com/tools/html-analyzer/v1`. 8 методов. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/html-analyzer.json. UI https://mailganer.com/tools/html-analyzer
- [Email Screenshot](https://tools.mailganer.com/email-screenshot): HTML письма → миниатюра и полный PNG без хранения файлов. REST `https://mailganer.com/tools/email-screenshot/v1`. 2 метода. доступ: опционально Bearer / X-Api-Key; капча или Authorization: Bearer. OpenAPI https://tools.mailganer.com/openapi/email-screenshot.json. UI https://mailganer.com/tools/email-screenshot
- [Проверка RSS](https://tools.mailganer.com/rss-check): Лента → поля Mailganer, картинки и готовность к импорту в рассылку. REST `https://mailganer.com/tools/rss-check/v1`. 3 метода. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/rss-check.json. UI https://mailganer.com/tools/rss-check
- [Проверка ссылки](https://tools.mailganer.com/url-check): Цепочка редиректов из письма и репутация доменов в VirusTotal. REST `https://mailganer.com/tools/url-check/v1`. 4 метода. доступ: капча; капча или X-Internal-Token. OpenAPI https://tools.mailganer.com/openapi/url-check.json. UI https://mailganer.com/tools/url-check

### База и compliance

- [Email-валидатор](https://tools.mailganer.com/validation): Экспресс-проверка одного адреса: синтаксис, MX и статус. REST `https://mailganer.com/tools/validation/v1`. 2 метода. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/validation.json. UI https://mailganer.com/tools/validation
- [Заявка на AMP](https://tools.mailganer.com/amp-request): Помощь в оформлении заявки на AMP-письма — форма и подсказки. REST `https://mailganer.com/tools/amp-request/v1`. 4 метода. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/amp-request.json. UI https://mailganer.com/tools/amp-request

### Вёрстка

- [Добавить в календарь](https://tools.mailganer.com/add-to-calendar-email): HTML-кнопка и ссылки Google / Яндекс / Outlook + .ics для iCloud и Mail.ru. REST `https://mailganer.com/tools/add-to-calendar-email/v1`. 1 метод. доступ: капча. OpenAPI https://tools.mailganer.com/openapi/add-to-calendar-email.json. UI https://mailganer.com/tools/add-to-calendar-email
- [Таймер обратного отсчёта](https://tools.mailganer.com/email-countdown-timer): Анимированный GIF для письма — актуальный остаток времени при каждом открытии. REST `https://mailganer.com/tools/email-countdown-timer/v1`. 3 метода. доступ: капча или X-Countdown-Token. OpenAPI https://tools.mailganer.com/openapi/email-countdown-timer.json. UI https://mailganer.com/tools/email-countdown-timer

## Optional

- [HTML-хаб: Auth + Swagger](https://tools.mailganer.com/): все 116 методов
- [Auth](https://tools.mailganer.com/#auth): как получить Bearer-ключ
- [Карта UI /tools](https://mailganer.com/tools/llms.txt): живые страницы, не REST
- [Карта сайта Mailganer](https://mailganer.com/llms.txt)
- [SaM oTPravil](https://samotpravil.ru/tools/llms.txt): MX Router на SMTP-продукте