API, toplu mektup ve e-postayla gönderim

Mektupları doğrudan yazılımınızdan gönderin – REST API ile, toplu mektup olarak veya sadece e-postayla. Claude bağlayıcısı aynı işlevleri kullanır.

Kimlik doğrulama

Hesap → API anahtarları altında bir anahtar oluşturun ve bearer token olarak gönderin. Her istek yalnızca o hesabın bakiyesinden düşülür.

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

OpenAPI açıklaması: https://mcpbrief.de/openapi.json

Uç noktalar

GET	/balance	Bakiye, fiyatlar, gönderen, günlük limit
POST	/letter/price	Adresi kontrol et, mektubu oluştur, sayfa ve fiyat + PDF önizleme (hiçbir şey göndermez)
POST	/letter/send	Mektup gönder (metin, PDF, DOCX, görsel; ekler, dupleks, masraf merkezi)
GET	/letter/{id}	Durum ve takip numarası
POST	/letter/{id}/cancel	Baskıdan önce iptal (iade)
POST	/letter/{id}/resend	Yeniden gönder
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Mektuplarınızın listesi, filtrelenebilir
POST	/letters/batch/price	Toplu mektubu kontrol et: tüm adresler, yer tutucular, toplam fiyat
POST	/letters/batch/send	Toplu mektup gönder (en fazla 200 alıcı)

Örnek: ekli taahhütlü mektup

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

Örnek: toplu mektup

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-postayla mektup

Programlama gerekmez: her hesabın kişisel bir sipariş adresi vardır. Hesap e-postanızdan bu adrese gönderdiğiniz PDF’ler mektup olarak postalanır.

Her PDF eki = bir mektup, adres pencere alanında (DIN 5008)
Konu satırı seçenekleri belirler: Taahhütlü, Öncelikli, Renkli, Dupleks, Ref: …, Ülke: …
Konuda “Ek”: tüm dosyalar tek bir mektupta birleştirilir
Konuda “Test”: yalnızca kontrol edilir ve fiyat e-postayla bildirilir – hiçbir şey gönderilmez

Durum değerleri

Durum uç noktası, liste ve e-posta bildirimi güncel durumu gösterir.

`pending`	sırada
`processing`	baskı ve zarflama
`mailed`	postaya teslim edildi
`failed`	gönderilmedi
`cancelled`	iptal edildi
`undeliverable`	teslim edilemedi
`rejected`	reddedildi