البدء السريع
تتيح Send API للبريد المعاملاتي للواجهة الخلفية الخاصة بك تشغيل إرسال رسالة — بالطريقة نفسها التي تستدعي بها نقطة نهاية الإرسال في Brevo أو SendGrid أو Postmark. وهي مناسبة بطبيعتها لرموز التحقق لمرة واحدة (OTP) والإيصالات والتنبيهات، ويمكنها أيضًا إطلاق مشروع صمّمته في الاستوديو، مع بياناتك الخاصة بديلًا عن صف جهة اتصال.
إنشاء مفتاح
ضمن المطوّرون في لوحة التحكم، اضغط إنشاء مفتاح وامنحه اسمًا (مثل «Production backend» أو «Staging»). يُعرض المفتاح الكامل — mia_live_... — مرة واحدة فقط. احفظه في مكان آمن؛ فـ MailInApp لا يحتفظ إلا بقيمة تجزئة له، فلا سبيل لاسترجاعه مرة أخرى. وإن فقدته، فألغِه وأنشئ مفتاحًا جديدًا.
المفاتيح مقيّدة بحسابك، لا بمشروع واحد — فمفتاح واحد يستطيع تشغيل أي مشروع تملكه. أنشئ ما تشاء منها (مفتاح لكل بيئة أو تكامل نمط شائع) وألغِ أيًّا منها بشكل مستقل في أي وقت.
الإرسال #1: الإرسال الحر
لرسالة معاملاتية بسيطة — دون أي مشروع في الاستوديو — قدّم HTML والنص بنفسك:
curl -X POST https://mailinapp.com/api/v1/send \
-H "Authorization: Bearer mia_live_..." \
-H "Content-Type: application/json" \
-d '{
"to": "[email protected]",
"subject": "Your one-time code",
"html": "<p>Your code is 123456</p>",
"text": "Your code is 123456"
}'
يعيد الاستدعاء الناجح:
{ "id": "abc123", "status": "sent" }
الإرسال #2: القالب
وهذا هو ما يميّزنا فعلًا: صمّم رسالة بصريًا في الاستوديو — محرك البدائل، والعناصر التفاعلية، ووسوم الدمج — ثم شغّلها من شيفرة التسجيل أو الدفع أو الدعم الخاصة بك مع mergeData بديلًا عن صف مصدر بيانات:
curl -X POST https://mailinapp.com/api/v1/send \
-H "Authorization: Bearer mia_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order_12345" \
-d '{
"to": "[email protected]",
"projectId": "your-project-id",
"mergeData": { "name": "Ada", "orderId": "12345" }
}'
تجد projectId في رابط الاستوديو الخاص بالمشروع (/studio/<projectId>). وتُحلّ حقول mergeData في وسوم الدمج {{field}} الخاصة بالمشروع تمامًا كما يفعل صف جهة اتصال. ويحصل المستلم على رابط عرض مباشر شخصي وموقّع كأي إرسال آخر — فتعمل العناصر التفاعلية (الاستطلاعات، والتقييمات، والنماذج)، ويتدفق كل رد إلى عرض الردود المعتاد لذلك المشروع وإلى تسليمات Webhook، منسوبًا إلى استدعاء API هذا تحديدًا.
ترويسة Idempotency-Key اختيارية لكنها موصى بها لكل ما تُطلقه عملية قابلة لإعادة المحاولة (Webhook دفع، أو مستهلك طابور) — راجع منع التكرار (idempotency) في مرجع API.
تجاوز المُرسِل
يستخدم نوعا الإرسال افتراضيًا هوية المُرسِل المضبوطة في حسابك — بطاقة «عنوان المُرسِل» في الإعدادات ← النطاقات إن كنت تستخدم الإرسال المباشر (SES)، أو عنوان المُرسِل في خادم ترحيل SMTP خلاف ذلك. أضف from لتجاوزها في استدعاء واحد، كحساب متعدد العلامات التجارية يرسل باسم فريق محدد مثلًا:
curl -X POST https://mailinapp.com/api/v1/send \
-H "Authorization: Bearer mia_live_..." \
-H "Content-Type: application/json" \
-d '{
"to": "[email protected]",
"subject": "Your one-time code",
"html": "<p>Your code is 123456</p>",
"text": "Your code is 123456",
"from": { "email": "[email protected]", "name": "Your Sales Team" }
}'
الحقل from.email مطلوب متى وُجد from أصلًا (فلا تجاوز للاسم وحده)؛ وfrom.name اختياري. وفي الإرسال المباشر (SES)، يجب أن يكون from.email عنوانًا على أحد نطاقاتك الموثّقة — راجع عنوان المُرسِل في مرجع API لمعرفة السبب والقاعدة الأكثر تساهلًا في SMTP.
وإن كنت قد حفظت هوية مُرسِل في لوحة التحكم، فمرّر معرّفها بوصفه senderId بدلًا من تكرار العنوان/الاسم ضمن الطلب — راجع مرجع API للاطلاع على كلا الحقلين.
الخطوات التالية
- الأشكال الكاملة للطلب/الاستجابة، ودلالات
type، وحدود المعدّل، ورموز الأخطاء: مرجع API. - تظهر الاستدعاءات الأخيرة التي أُجريت بمفاتيحك — بما في ذلك الحالة وأي خطأ — في صفحة المطوّرون لأغراض التدقيق.
- لا تملك خادم ترحيل SMTP؟ يتيح الإرسال المباشر لـ MailInApp التسليم نيابة عنك، بمجرد إدراج نطاقك في قائمة السماح وتوثيقه.
- تريد وكيل ذكاء اصطناعي يبني رسائلك أو يعدّلها بدلًا من استدعاء API مباشرة؟ المفتاح نفسه يصادق أيضًا على خادم MCP، فيستطيع Claude Desktop أو Claude Code أو أي عميل MCP آخر فعل ذلك نيابة عنك عبر الدردشة.