المطوّرون

لا يهمّ صندوق البريد
من يقود.

كل ما يفعله التطبيق يفعله كودك: 104 عمليات موثّقة عبر 68 مساراً، خلف مستند OpenAPI 3.1 يمكنك قراءته دون مفتاح. وعميل TypeScript مُلزَم بذلك المستند في كل بناء.

ألصقه في أي عميل MCP. يسجّل نفسه بنفسه.
{ "mcpServers": {
    "openemail": {
      "url": "https://api.openemail.uk/mcp"
    } } }

لا يحتاج MCP إلى مفتاح تلصقه. يكتشف العميل خادم التفويض من نقطة النهاية، ويسجّل نفسه، ويرسلك إلى هنا لتسجيل الدخول.

104

عملية موثّقة

68

مساراً تحت مضيف واحد

116

دالة SDK، تغطيها جميعاً

20

حدث خطاف ويب، في ثلاث عائلات

مستند OpenAPI 3.1 على GET /openapi.json، وقراءته لا تحتاج مفتاحاً.

الواجهات

ثلاثة أبواب،
صندوق بريد واحد.

واجهة REST API

مفتاح مساحة العمل يحدّد ما يجوز للاستدعاء فعله وأي العناوين يجوز له الإرسال باسمها. والإبطال تحديث لا حذف، فيُبلَّغ أي استدعاء لاحق بأن المفتاح أُبطل.

/threads?query=invoice
/emails
emails:sendthreads:readwebhooks:write

يرسل المفتاح باسم ما يصل إلى 25 نطاقاً كاملاً و50 عنواناً مفرداً. ويعيد GET /ping قراءة النطاقات التي يحملها والنطاقات التي أبقاها له دوره.

خادم MCP

وجّه عميلاً إلى نقطة النهاية وسجّل الدخول. لا مفتاح تلصقه، لأن العميل يسجّل نفسه ويرسلك إلى هنا.

listThreads
threads:reademails:sendlabels:write

تُبنى الأدوات مما يجوز للمستدعي فعله، فالعميل المحصور بالقراءة لا أداة إرسال فيه. ومع ذلك يصل الرمز إلى صندوق البريد كاملاً.

خطافات الويب

سجّل نقطة نهاية https فيرسل إليها صندوق البريد. والتسليمات يطلقها صندوق البريد نفسه لا استدعاء API، فالكتابة في التطبيق والإرسال إلى الواجهة يُطلقان التسليم نفسه.

/webhooks
email.receivedemail.sentemail.failedemail.openeddomain.verifiedsuppression.added

20 حدثاً في ثلاث عائلات، وعشر نقاط نهاية لكل صندوق بريد.

التكافؤ

لا يمكن للعميل أن يتأخر
عن الواجهة.

يقرأ فحص التكافؤ مستند OpenAPI في كل بناء ويفشل عند أي انحراف: دالة تشير إلى عملية لا يملكها التوصيف، أو عملية موثّقة بلا دالة، أو قائمة نطاقات تخالف ما تتطلبه العملية. ويطبع ما أثبته، وهو اليوم 116 دالة SDK تغطي كل العمليات الموثّقة الـ104.

إرسال واحد بثلاث طرق

الإعداد والطلب والاستدعاء عملية واحدة، مكتوبة بثلاث طرق.

MCPAPISDK
{ "mcpServers": {
"openemail": {
"url": "https://api.openemail.uk/mcp"
} } }
01 · 5 ميزة، و1 في الطريق

الوكلاء وAPI وMCP

OpenEmail مصمَّم ليُشغَّل ببرمجيات كما يُشغَّل بأشخاص. وصندوق البريد هو نفسه في الحالتين.

/threads?query=invoice
{ "threads": 12 }
صندوق البريد نفسه، سواء أمسكه شخص أم برنامج.

خادم MCP

وجّه Claude، أو أي عميل MCP، إلى صندوق بريدك.

/threads?query=invoice
{ "threads": 12 }
صندوق البريد نفسه، سواء أمسكه شخص أم برنامج.

OAuth لتطبيقات الطرف الثالث

قريبًا

تسجيل ذاتي للتطبيقات باستخدام PKCE، ليطلب التطبيق الوصول كما ينبغي.

الموافقة والإلغاء متوفّران؛ أمّا النطاق فلا، لذا يصل الرمز إلى صندوق بريدك كاملًا بدل الجزء الذي طلبه التطبيق.

/threads?query=invoice
{ "threads": 12 }
صندوق البريد نفسه، سواء أمسكه شخص أم برنامج.

واجهة REST API

واجهة HTTP موثّقة بمفاتيح قابلة للإصدار والتقييد والإبطال.

/threads?query=invoice
{ "threads": 12 }
صندوق البريد نفسه، سواء أمسكه شخص أم برنامج.

حزم SDK مُحدَّدة الأنواع

عميل TypeScript أولًا، ثم البقية.

/threads?query=invoice
{ "threads": 12 }
صندوق البريد نفسه، سواء أمسكه شخص أم برنامج.

خطافات الويب

أبلِغ نقطة النهاية لديك عند وصول البريد، بدل أن تضطر إلى الاستعلام المتكرر.

/threads?query=invoice
{ "threads": 12 }
صندوق البريد نفسه، سواء أمسكه شخص أم برنامج.

بداية سريعة

من لا شيء إلى رسالة مُرسَلة.
ثلاث خطوات.

  1. 1

    أنشئ مفتاحاً

    الإعدادات، مفاتيح API، على صندوق بريد تملكه. اختر نطاقاته، وضيّق ما يجوز له الإرسال باسمه إلى نطاقات كاملة أو عناوين مفردة. يُعرض السرّ مرة واحدة، وما يُخزَّن هو تجزئة أحادية الاتجاه.

    يجيب GET /ping بالنطاقات الموجودة على المفتاح والنطاقات التي أبقاها له دوره.
    export OPENEMAIL_API_KEY=oe_live_9f2c1a4b7e05d3862c1f0a44_kX7… curl https://api.openemail.uk/ping \  -H "Authorization: Bearer $OPENEMAIL_API_KEY"
  2. 2

    ثبّت العميل

    عميل TypeScript بلا تبعيات، منشور بصيغتي ESM وCommonJS، يقرأ المفتاح من OPENEMAIL_API_KEY. تجاوزه إن كنت تفضّل إرسال JSON بنفسك، فكل نقطة نهاية هي HTTP صِرف.

    Node 18 فما فوق، وWorkers وDeno وBun والمتصفح.
    bun add @openemail/sdk
  3. 3

    أرسل

    تحمل الاستجابة المعرّف. وGET /emails/{id} يحلّه، و/events فيه الأثر لكل مستلم، و/tracking فيه عمليات الفتح والنقر.

    إعادة المحاولة بالمفتاح Idempotency-Key نفسه تعيد النتيجة الأولى مع Idempotency-Replayed: true.
    import { init, openemail } from '@openemail/sdk' init({ apiKey: process.env.OPENEMAIL_API_KEY }) const email = await openemail.emails.send({  from: 'Acme Billing <[email protected]>',  to: '[email protected]',  subject: 'Your September invoice',  html: '<p>Invoice attached.</p>',}) console.log(email.id, email.status)

غائب

ما لن يفعله
لك بعد.

خمسة أمور يجدر معرفتها قبل أن تبني على هذا، لا بعده.

لا نقطة نهاية للرفع
تُرسَل المرفقات المضمّنة بصيغة base64 ضمن حد إجمالي قدره 5 ميغابايت. ويُرسَل الملف الأكبر بتسمية ملف موجود في مساحة العمل بمعرّفه، فينتقل كرابط تنزيل.
الارتدادات تتوقف عند صندوق البريد
يُحلَّل تقرير التسليم، ويُطابَق عبر Message-ID، ويُوسَم على المحادثة، ويُدفَع كخطاف ويب email.bounced. لا شيء يكتب مرة أخرى في سجل الإرسال، لذا تبقى الرسالة المرتدّة عبر GET /emails مقروءة على أنها مُرسَلة.
بريد المحرّر ليس في GET /emails
لا يظهر البريد المُرسَل من محرّر التطبيق في تلك القائمة، لأن المحرّر لا يكتب عبر مسار الإرسال نفسه.
OAuth فيه موافقة، لا نطاق
يُعرَض الطلب قبل منحه، و«التطبيقات المتصلة» تسحبه، لكن الرمز يصل إلى صندوق بريدك كاملاً لا إلى الجزء الذي طلبه التطبيق.
لا سير عمل للإصدار
نشر العميل تشغيل يدوي للفحص المسبق والبناء وbun publish، فتصل النسخة إلى npm حين يشغّلها أحدهم لا حين يصل التغيير.

التحقق من التسليم

كل تسليم موقّع،
وكل إعادة محاولة تحمل معرّفه.

التوقيع هو HMAC-SHA-256 على الطابع الزمني ونقطة والجسم الخام. تحقّق مقابل البايتات كما وصلت، لأن التحليل وإعادة التسلسل يعيدان ترتيب المفاتيح فيُفسدانه.

ترويسات على كل تسليم
X-OpenEmail-Signature: t=1758240000,v1=9f0c4b2e7d1a86c3X-OpenEmail-Event: email.deliveredX-OpenEmail-Delivery: evt_4b7e05d3862c1f0a
نافذة إعادة الإرسال
300 ثانية، وفرضها مهمة المستقبِل. والمُتحقِّق في SDK يعتمدها افتراضياً.
Idempotency-Key
يُحجَز مقابل فهرس فريد على المفتاح ومفتاح API الخاص بك معاً، فإعادة المحاولة بعد انتهاء المهلة تعيد النتيجة الأولى مع Idempotency-Replayed: true بدل الإرسال مرتين.
إعادات المحاولة
خمس محاولات: عند وقوع الحدث، ثم بعد دقيقة و5 و25 دقيقة وساعتين. ولا يُعاد إلا مع انتهاء مهلة أو اتصال مرفوض أو 408 أو 425 أو 429 أو 5xx.
X-OpenEmail-Delivery
يُنشأ معرّف الحدث مرة واحدة وتحمله كل محاولة، فالمستقبِل الذي يرى المعرّف نفسه مرتين يمكنه إسقاط الثانية بدل التصرف بها من جديد.

لمن هذا

صندوق بريد واحد.
ثلاثة مداخل إليه.

الأفراد

عنوان مجاني على openemail.uk، وخلفه التطبيق.

acme.comacme.devstudio.acme.com
hello@acme.comسُلِّمت
billing@acme.comسُلِّمت
oct-2026-signup@acme.comسُلِّمت
anything-at-all@acme.comسُلِّمت
الشركات

عناوين للجميع، بلا احتساب الأعضاء كمقاعد.

[email protected]مُشترَك
SSarahAAliJJamieNNadia
لا مقعد إضافي. الفاتورة لا تتغير.
المطوّرون

صندوق البريد نفسه عبر API وSDK وMCP.

/threads?query=invoice
{ "threads": 12 }
صندوق البريد نفسه، سواء أمسكه شخص أم برنامج.

أنشئ مفتاحاً.
أرسل شيئاً.

Full API, MCP and SDK access في كل خطة. وFree تحمل معها 50 AI actions a day.

اقرأ دليل البدء السريع لواجهة API

صندوق بريدك،
بشروطك أنت.

بنية بريد إلكتروني للشركات والذكاء الاصطناعي والوكلاء والبريد الشخصي. مبنية للتوسّع والخصوصية والتحكّم. كل ما كان ينبغي للبريد الإلكتروني أن يملكه منذ اليوم الأول.

OpenEmail

بنية بريد إلكتروني للشركات والذكاء الاصطناعي والوكلاء والبريد الشخصي. مبنية للتوسّع والخصوصية والتحكّم. كل ما كان ينبغي للبريد الإلكتروني أن يملكه منذ اليوم الأول.

الأدوات
فاحص قابلية التسليممولّد سجل DMARCفاحص شعار BIMIعنوان بريد مؤقتحاسبة تكلفة البريد
الشركة
من نحناتصل بناالتوثيقسياسة الخصوصيةشروط الخدمة
© 2026 OpenEmail. جميع الحقوق محفوظة.
الحالة