# Сам Отправил API
# https://spec.samotpravil.ru/llms.txt

> SMTP-сервис «Сам Отправил»: машиночитаемое описание REST API для отправки писем, статусов доставки, отчётов, стоп-листов, доменов отправителя, ключей и вебхуков.

Эту ссылку отдают разработчику внешней платформы или его ИИ-агенту. Дальше интеграция пишется без обращения в поддержку.

## Спецификация

- [OpenAPI 3](https://spec.samotpravil.ru/openapi.yaml): сам файл, основной вход для агента
- [Справочник](https://spec.samotpravil.ru/reference/): человекочитаемая версия того же файла
- [Swagger UI](https://spec.samotpravil.ru/swagger/): вызвать метод из браузера со своим ключом
- [Документация Postman](https://documentation.samotpravil.ru/): исходник спецификации и гайды

## API

- Production: https://api.samotpravil.ru
- Тот же бэкенд для ЛК Mailganer: https://smtp.mailganer.com
- Авторизация: заголовок `Authorization: <ключ>` без префикса
- Ключ API: после регистрации в ЛК и верификации домена отправителя. Бесплатного тестового ключа без регистрации/DNS нет (#21204). Поддержка: smtp@samotpravil.ru
- MCP (Cursor Directory): https://cursor.directory/plugins/samotpravil-api-mcp — `npx -y samotpravil-mcp@latest`
- MCP (GitHub): https://github.com/dkanster/samotpravil-api-mcp
- MCP (PyPI): https://pypi.org/project/mailganer-samotpravil-mcp/ — `pip install mailganer-samotpravil-mcp`
- MCP (Smithery): https://smithery.ai/servers/daniil-kozemiakin/samotpravil
- Node-клиент: https://www.npmjs.com/package/samotpravil — `npm install samotpravil`
- Python-клиент: пакет `samotpravil` на PyPI; вебхуки — `parse_webhook` (MR samotpravil-lib !1)
- Пример SaaS (два ключа): https://github.com/dkanster/samotpravil-example
- Вебхуки: при ошибке/таймауте эндпоинта — повтор того же тела каждые 15 минут в течение суток; приёмник идемпотентный (#18737)

## Гайды по интеграции

- [Схемы интеграции](https://samotpravil.ru/blog/skhemy-integracii-sam-otpravil): типовая отправка, модуль рассылок, White Label
- [Типовая интеграция — доска](https://www.figma.com/board/8r9fXm7UtqIMXFL4hpx0zV/%D0%A2%D0%B8%D0%BF%D0%BE%D0%B2%D0%B0%D1%8F-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D1%81-%D0%A1%D0%B0%D0%BC-%D0%9E%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB?node-id=24-184): схемы со ссылками на методы API
- [Особенности интеграции с SMTP](https://samotpravil.ru/blog/osobennosti-integracii-smtp): стоп-листы, 550, несколько ключей, выделенный сендер

## Сайт продукта

- [Карта сайта Сам Отправил](https://samotpravil.ru/llms.txt) (на apex после cutover; сейчас живая карта — newland)
- [Пакетная отправка](https://newland.samotpravil.ru/batch-send-500k/)
- [Вебхуки доставки](https://newland.samotpravil.ru/delivery-webhooks/)
- [Жалобы и недоставки](https://newland.samotpravil.ru/fbl-and-bounces/)
- [Замена зарубежного SMTP](https://newland.samotpravil.ru/replace-foreign-smtp/)
- [Транзакции vs маркетинг](https://newland.samotpravil.ru/transactional-vs-marketing/)