API, серійні листи та надсилання через e-mail

Надсилайте листи безпосередньо з Вашого програмного забезпечення – через REST API, як серійний лист або просто електронною поштою. Конектор Claude використовує ті самі функції.

Автентифікація

Створіть ключ у розділі Обліковий запис → API-ключі і передавайте його як bearer token. Кожен запит списує кошти лише з балансу відповідного облікового запису.

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"
}'

Листи через e-mail

Без програмування: кожен обліковий запис має персональну адресу для замовлень. PDF, які Ви надсилаєте на цю адресу з e-mail облікового запису, відправляються як листи.

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

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

Ендпоінт статусу, список і сповіщення електронною поштою показують поточний стан.

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