البدء السريع

احصل على مفتاح APIنسخ رابط القسم

بعد إنشاء حسابك ومساحة عملك، افتح Credentials من الشريط الجانبي وأنشئ بيانات اعتماد جديدة:

• المنتج: الإرسال
• الوضع: إنتاج (أو Sandbox للاختبار)
• التدفق: معاملاتي
• القناة: API

انسخ مفتاح API: يُعرَض مرة واحدة فقط. يبدو المفتاح كالتالي:

ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

تُشفّر البادئة نوع بيانات الاعتماد:

• ml_: تبدأ جميع مفاتيح MailLand بهذه البادئة
• p أو s: وضع الإنتاج أو Sandbox
• e أو i أو v، منتج الإرسال/البريد أو الوارد أو التحقق (مفاتيح الإرسال تحمل أيضاً حرف تدفق: et للمعاملاتي، em للتسويقي، مثال: ml_pet_...)

أرسل رسالة بريد إلكترونينسخ رابط القسم

أرسل طلب POST إلى نقطة نهاية الإرسال مع تفاصيل رسالتك:

curl -X POST https://api.mail.land/v1/transactional/send \
  -H "X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "[email protected]",
      "name": "Your App"
    },
    "to": [
      {
        "email": "[email protected]",
        "name": "Jane Doe"
      }
    ],
    "subject": "Welcome to our platform",
    "htmlContent": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "textContent": "Welcome! Thanks for signing up."
  }'

تحقق من الاستجابةنسخ رابط القسم

تُرجع الاستجابة الناجحة 202 Accepted مع تفاصيل عن الرسالة الموضوعة في الطابور:

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "messageIds": ["t_a1b2c3d4e5f6..."],
  "acceptedRecipients": ["[email protected]"],
  "rejectedRecipients": [],
  "queuedAt": "2026-02-17T10:30:00Z",
  "isSandboxed": false
}

الحقول الرئيسية:

• jobId: معرّف فريد لتتبع عملية الإرسال هذه
• messageIds: معرّفات الرسائل الفردية (بادئة t_ للمعاملاتي، m_ للتسويقي)
• acceptedRecipients: عناوين البريد الإلكتروني التي تم قبولها للتسليم
• rejectedRecipients: عناوين البريد الإلكتروني التي تم رفضها (مع الأسباب)
• isSandboxed: true إذا استخدم الطلب بيانات اعتماد sandbox: سُجّلت الرسالة دون إرسالها، أو أُرسلت فقط إلى مستلمي قائمة السماح