API, মেইল মার্জ ও ইমেইলে পাঠানো

প্রমাণীকরণ

অ্যাকাউন্ট → API কী-তে একটি কী তৈরি করুন এবং এটি bearer token হিসেবে পাঠান। প্রতিটি অনুরোধ শুধু সেই অ্যাকাউন্টের ব্যালান্স থেকে চার্জ করে।

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

OpenAPI বিবরণ: https://mcpbrief.de/openapi.json

এন্ডপয়েন্ট

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”: শুধু যাচাই এবং ইমেইলে মূল্য পান – কিছু পাঠানো হয় না

অবস্থার মান

স্ট্যাটাস এন্ডপয়েন্ট, তালিকা ও ইমেইল বিজ্ঞপ্তি বর্তমান অবস্থা দেখায়।