Для разработчиков и интеграторов

Дослано API

Отправляйте заказные письма Почтой России прямо из вашей CRM, 1С или бэкенда. Письмо со всеми получателями и оплатой — один REST-запрос; статусы и трек-номера — колбеком на ваш URL или поллингом.

Письмо — одним запросом

PDF передаётся прямо в запросе — ссылкой или base64. Опись вложения формируется автоматически, оплата списывается с баланса аккаунта, цена возвращается в ответе.

curl -X POST https://integration.doslano.ru/v1/letters \
  -H "Authorization: Bearer dl_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": [
      { "name": "Иванов Иван Иванович",
        "address": "101000, г Москва, ул Мясницкая, д 1, кв 1" }
    ],
    "content": { "main_file": { "url": "https://example.com/letter.pdf" } },
    "callback_url": "https://crm.example.com/hooks/doslano"
  }'

Что умеет API

Авторизация — ключ dl_live_… в заголовке Bearer. Полный контракт — в OpenAPI-документации.

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

До 20 получателей в одном письме, PDF до 25 МБ (base64 или ссылкой) плюс вложения. Опись — автоматически. Идемпотентность по заголовку Idempotency-Key: повтор запроса не создаёт дубликат.

Статусы и трекинг

Наш номер отправления (РПО) — сразу в ответе; трек-номер Почты России — после регистрации. Статус каждого получателя и события трекинга — отдельными эндпоинтами.

Колбеки

Укажите callback_url при отправке — финальные статусы письма и получателей прилетят на ваш URL. Подпись HMAC-SHA256, повторы с нарастающим интервалом, дедупликация по event_id.

Баланс и оплата

Оплата списывается с баланса аккаунта; пополнение — в личном кабинете. Промокоды применяются в том же запросе. Поведение при нехватке средств управляется флагом.

Ключи и права

Несколько ключей с разными правами: отправка, чтение, баланс. IP-ограничения на ключ. О каждом изменении ключей — письмо на email владельца аккаунта.

LOG

Журнал активности

Каждый API-запрос виден в личном кабинете: метод, путь, статус, IP и время ответа. Журнал доставки колбеков — со статусами попыток.

Как начать

Спецификация — OpenAPI 3.1: openapi.yaml. Интерактивная документация — integration.doslano.ru/docs.

Выпустите ключ

В личном кабинете, раздел API: задайте имя, права доступа и при необходимости IP-ограничения. Секрет показывается один раз.

Отправьте письмо

POST /v1/letters — получатели, PDF и оплата в одном запросе. В ответе — id письма, номера отправлений и итоговая цена.

Получите статус

Колбек на ваш callback_url (подпись X-Doslano-Signature) — или поллинг GET /v1/letters/{id}.

Готовые SDK

Официальные клиенты генерируются из OpenAPI-спецификации и публикуются на GitHub — github.com/doslano-ru.

⌥Go ⌥Python ⌥PHP ⌥JavaScript / TypeScript ⌥Java

Кому это пригодится

Юристы и коллекторские агентства

Массовая отправка претензий, фиксация даты вручения для последующих исков. Реестр отправлений — в выгрузке для дела.

Бухгалтерия и финдеп

Претензионная переписка с контрагентами по неоплате прямо из 1С. Акты сверки, требования о взыскании — без распечатки.

Госорганы и сервисные компании

Уведомления о смене реквизитов, графика приёма, плановых работах. Подтверждённая доставка вместо звонков и SMS.

CRM и SaaS-сервисы

Готовый коннектор-модуль для отправки заказного письма прямо из карточки клиента. White-label для агентских моделей.

Готовы подключиться?

Выпустите ключ в личном кабинете и отправьте первое письмо за десять минут. Вопросы по интеграции — support@doslano.ru.