شروع سریع

دریافت کلید APIکپی پیوند بخش

پس از ایجاد حساب و فضای کاری، از نوار کناری اعتبارنامه‌ها (Credentials) را باز کنید و یک اعتبارنامه جدید ایجاد کنید:

• محصول: Sending
• حالت: Production (یا Sandbox برای تست)
• جریان: Transactional
• کانال: API

کلید API را کپی کنید: فقط یک بار نمایش داده می‌شود. کلید به این شکل است:

ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

پیشوند نوع اعتبارنامه را مشخص می‌کند:

• ml_: تمام کلیدهای MailLand با این شروع می‌شوند
• p یا s: حالت Production یا Sandbox
• e، i یا v، محصول Sending/Email، Inbound یا Validation (کلیدهای Sending یک حرف جریان هم دارند: et برای تراکنشی، em برای بازاریابی، مثلاً ml_pet_...)

ارسال یک ایمیلکپی پیوند بخش

یک درخواست POST به endpoint ارسال با جزئیات ایمیل خود بفرستید:

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 ارسال شده باشد: ایمیل ثبت شده اما ارسال نشده، یا فقط به گیرندگان فهرست مجاز ارسال شده است