API، میل مرج اور ای میل سے ترسیل

اپنے سافٹ ویئر سے براہ راست خطوط بھیجیں – 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"
}'

ای میل کے ذریعے خطوط

پروگرامنگ کی ضرورت نہیں: ہر اکاؤنٹ کا ایک ذاتی آرڈر پتہ ہوتا ہے۔ آپ اپنے اکاؤنٹ کی ای میل سے اس پتے پر جو PDFs بھیجتے ہیں وہ خطوط کے طور پر روانہ ہو جاتی ہیں۔

ہر PDF منسلکہ = ایک خط، پتہ کھڑکی والے حصے میں (DIN 5008)
موضوع اختیارات کنٹرول کرتا ہے: Registered، Priority، Colour، Duplex، Ref: …، Country: …
موضوع میں “Enclosure”: تمام فائلیں ایک خط میں یکجا کر دی جاتی ہیں
موضوع میں “Test”: صرف جانچ اور قیمت ای میل کے ذریعے – کچھ نہیں بھیجا جاتا

حیثیت کی اقدار

اسٹیٹس اینڈ پوائنٹ، فہرست اور ای میل اطلاع موجودہ حالت دکھاتے ہیں۔

`pending`	قطار میں
`processing`	پرنٹنگ اور لفافہ بندی
`mailed`	ڈاک کے حوالے کر دیا گیا
`failed`	نہیں بھیجا گیا
`cancelled`	منسوخ
`undeliverable`	ناقابلِ ترسیل
`rejected`	مسترد