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)
سطر الموضوع يتحكم في الخيارات: Registered، Priority، Colour، Duplex، Ref: …، Country: …
«Enclosure» في الموضوع: تُدمج جميع الملفات في رسالة واحدة
«Test» في الموضوع: فحص فقط وتلقّي السعر عبر البريد الإلكتروني – لا يُرسل شيء

قيم الحالة

تعرض نقطة نهاية الحالة والقائمة وإشعار البريد الإلكتروني الحالة الراهنة.

`pending`	في قائمة الانتظار
`processing`	قيد الطباعة والتغليف
`mailed`	سُلّمت إلى البريد
`failed`	لم تُرسل
`cancelled`	أُلغيت
`undeliverable`	تعذّر التوصيل
`rejected`	رُفضت