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)
Темата управлява опциите: Препоръчано, Приоритетно, Цветно, Дуплекс, Реф: …, Държава: …
„Приложение“ в темата: всички файлове се обединяват в едно писмо
„Тест“ в темата: само проверка и цена по имейл – нищо не се изпраща

Стойности на статуса

Крайната точка за статус, списъкът и известието по имейл показват текущото състояние.

`pending`	в опашка
`processing`	печат и пликосване
`mailed`	предадено на пощата
`failed`	не е изпратено
`cancelled`	анулирано
`undeliverable`	недоставимо
`rejected`	отхвърлено