API, серийные письма и отправка по эл. почте

Отправляйте письма прямо из Вашего ПО – через REST API, как серийное письмо или просто по эл. почте. Коннектор Claude использует те же функции.

Аутентификация

Создайте ключ в разделе Аккаунт → API-ключи и передавайте его как Bearer-токен. Каждый запрос списывает средства только с баланса этого аккаунта.

curl -H "Authorization: Bearer mbx_…" https://mcpbrief.de/api/v1/balance

Описание OpenAPI: https://mcpbrief.de/openapi.json

Эндпоинты

GET	/balance	Баланс, цены, отправитель, дневной лимит
POST	/letter/price	Проверить адрес, сформировать письмо, страницы и цену + PDF-предпросмотр (ничего не отправляет)
POST	/letter/send	Отправить письмо (текст, PDF, DOCX, изображение; приложения, дуплекс, центр затрат)
GET	/letter/{id}	Статус и трек-номер
POST	/letter/{id}/cancel	Отменить до печати (возврат)
POST	/letter/{id}/resend	Отправить повторно
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Список Ваших писем с фильтрами
POST	/letters/batch/price	Проверить серийное письмо: все адреса, плейсхолдеры, общая цена
POST	/letters/batch/send	Отправить серийное письмо (макс. 200 получателей)

Пример: заказное письмо с приложением

curl -X POST https://mcpbrief.de/api/v1/letter/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipient": {"name": "Muster GmbH", "street": "Ringstraße 5",
                "zip": "1010", "city": "Wien", "country": "AT"},
  "subject": "Rechnung 2026-17",
  "content": "Sehr geehrte Damen und Herren,\n\nanbei …",
  "attachments": [{"file_base64": "JVBERi0…", "file_name": "rechnung.pdf"}],
  "delivery": "registered", "duplex": true, "cost_center": "VERTRIEB",
  "idempotency_key": "7d1c2f0e-…"
}'

Пример: серийное письмо

curl -X POST https://mcpbrief.de/api/v1/letters/batch/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipients": [
    {"name": "Muster GmbH", "street": "Ringstraße 5", "zip": "1010",
     "city": "Wien", "country": "AT", "anrede": "Sehr geehrte Frau Huber"},
    {"name": "Beispiel AG", "street": "Hauptstraße 1", "zip": "10115",
     "city": "Berlin", "country": "DE", "anrede": "Sehr geehrte Damen und Herren"}
  ],
  "subject": "Preisanpassung 2027",
  "content": "{{anrede}},\n\nab 1. Jänner gelten neue Preise …",
  "delivery": "standard", "idempotency_key": "batch-2027-01"
}'

Письма по эл. почте

Без программирования: у каждого аккаунта есть персональный адрес для заказов. PDF, отправленные с эл. почты Вашего аккаунта на этот адрес, уходят как письма.

Каждое PDF-вложение = одно письмо, адрес в зоне окна (DIN 5008)
Тема управляет опциями: Registered, Priority, Colour, Duplex, Ref: …, Country: …
«Enclosure» в теме: все файлы объединяются в одно письмо
«Test» в теме: только проверка и цена по эл. почте – ничего не отправляется

Значения статуса

Эндпоинт статуса, список и уведомление по эл. почте показывают текущее состояние.

`pending`	в очереди
`processing`	печать и конвертирование
`mailed`	передано почте
`failed`	не отправлено
`cancelled`	отменено
`undeliverable`	не доставлено
`rejected`	отклонено