LE
Создание писем
Одиночные и пакетные отправки. PDF-вложения до 300 МБ суммарно, до 50 файлов на письмо. Идемпотентность по вашему request-id — повтор запроса не создаёт дубликат.
Для разработчиков и интеграторов
Дослано API
Программный доступ ко всем функциям сервиса для CRM-интеграторов, юр.отделов и сервисов автоматизации документооборота. Создание писем, проверка статусов, оплата и получение документов — без единого визита в личный кабинет.
Что вы сможете делать через API
Полный функционал ЛК доступен программно. Авторизация — Bearer-токен из вкладки «API-токены» в профиле.
TR
Трекинг и статусы
Опрос текущего состояния либо подписка на webhook: forming → paid → sending → sent. Полная история событий Почты России — приём, обработка, вручение.
PA
Оплата и баланс
Платёжная сессия для каждого письма или списание с предзаполненного баланса. Отдельные эндпоинты для пополнения, истории транзакций и выгрузки актов.
DO
Документы
Скачивание PDF — основной документ, опись формы 107, кассовая квитанция, payment-receipt. Стрим напрямую, без буферизации в памяти клиента.
RE
Реестры и поиск
GET /letters с фильтрами по дате, статусу, получателю и трек-номеру. Курсорная пагинация. Экспорт реестра отправлений в CSV или Excel.
SU
Адресные подсказки
Те же эндпоинты, что использует наш веб-интерфейс: автодополнение адресов, поиск организаций по ИНН/ОГРН с подтягиванием реквизитов.
Как это будет работать
Endpoint'ы и схемы запросов опубликуем вместе с релизом. Спецификация — OpenAPI 3.1; одновременно с публикацией подготовим SDK для Python и Node.js.
01
Получите токен
В личном кабинете во вкладке API токены сгенерируйте Bearer-токен. Один токен на аккаунт, моментальная ротация в один клик при компрометации.
02
Отправьте запрос
POST /v1/letters с прикреплёнными PDF и адресом получателя. Синхронный ответ возвращает letter_id и URL платёжной сессии — письмо уходит в очередь обработки.
03
Слушайте webhook
Каждое изменение статуса доставляется на ваш URL. Подпись HMAC-SHA256, retry с экспоненциальным backoff'ом, идемпотентность по event_id.
Кому это пригодится
Целевая аудитория API
Юристы и коллекторские агентства
Массовая отправка претензий, фиксация даты вручения для последующих исков. Реестр отправлений — в выгрузке для дела.
Бухгалтерия и финдеп
Претензионная переписка с контрагентами по неоплате прямо из 1С. Акты сверки, требования о взыскании — без распечатки.
Госорганы и сервисные компании
Уведомления о смене реквизитов, графика приёма, плановых работах. Подтверждённая доставка вместо звонков и SMS.
CRM и SaaS-сервисы
Готовый коннектор-модуль для отправки заказного письма прямо из карточки клиента. White-label для агентских моделей.