# MailInfra

> Транзакционный email API для российского рынка: отправка писем через REST или SMTP, верификация доменов, шаблоны, вебхуки и список подавления.

- Базовый URL Public API — `https://api.mailinfra.ru/v1`.
- Аутентификация отправки и чтения писем: `Authorization: Bearer mi_live_…` (продакшен) или `mi_test_…` (sandbox, письма не доставляются).
- Management API (домены, ключи, шаблоны, вебхуки, подавления) работает на сессионном токене пользователя, а не на API-ключе проекта.
- Вся документация одним файлом: https://docs.mailinfra.ru/llms-full.txt

## Начало работы

- [Быстрый старт](https://docs.mailinfra.ru/intro): Первое письмо через MailInfra API за 5 минут.
- [API-ключи](https://docs.mailinfra.ru/api-keys): Как устроены API-ключи MailInfra — формат, окружение, права доступа.
- [Management API](https://docs.mailinfra.ru/management-api): Программное управление ресурсами организации — ключи, домены, шаблоны, вебхуки, список подавления.
- [MailInfra в ИИ-ассистентах](https://docs.mailinfra.ru/ai-agents): Как подключить документацию MailInfra к Claude, ChatGPT, Cursor и Copilot через llms.txt, чтобы ассистент писал рабочий код, а не выдумывал поля.

## Отправка писем

- [Одно письмо](https://docs.mailinfra.ru/sending/single-email): Полный справочник POST /v1/emails — параметры, ответы, идемпотентность.
- [Пакетная отправка](https://docs.mailinfra.ru/sending/batch): До 100 писем за один запрос через POST /v1/emails/batch.
- [Шаблоны](https://docs.mailinfra.ru/sending/templates): Jinja2-шаблоны писем — синтаксис, отправка по slug, безопасность.
- [Отправка по SMTP](https://docs.mailinfra.ru/sending/smtp): Подключение без кода — обычный SMTP для WordPress, 1С, Битрикс, CRM и любых библиотек. Хост, порты, коды ответов, лимиты.
- [Click tracking](https://docs.mailinfra.ru/sending/click-tracking): Как включить отслеживание кликов, какие ссылки переписываются и какие события приходят в вебхуки.

## Домены

- [Обзор доменов](https://docs.mailinfra.ru/domains/overview): Зачем верифицировать домен и как он связан с проектами.
- [Настройка DNS](https://docs.mailinfra.ru/domains/dns-setup): Пошаговая настройка SPF, DKIM и DMARC для домена в MailInfra.

## Вебхуки

- [Вебхуки](https://docs.mailinfra.ru/webhooks/overview): Получайте события доставки писем по HTTP в реальном времени.
- [Проверка подписи](https://docs.mailinfra.ru/webhooks/signature): Верификация HMAC-SHA256 подписи входящих вебхуков MailInfra.

## Работа в дашборде

- [Обращения в поддержку](https://docs.mailinfra.ru/dashboard/support): Как создать обращение, ответить оператору и посмотреть вложения в дашборде MailInfra.

## Справочник

- [Список подавления](https://docs.mailinfra.ru/suppressions): Какие адреса MailInfra исключает из отправки и почему.
- [Ошибки и лимиты](https://docs.mailinfra.ru/errors): HTTP-коды, формат ошибок, rate limits и тарифные ограничения MailInfra.
- [Changelog](https://docs.mailinfra.ru/changelog): История изменений Public API MailInfra.