مستندات API

هنگامی که کلید را حمل نمی کنید ، می توانید به صورت ناشناس توسط بازدید کننده تماس بگیرید و تولید / خواندن صندوق پستی موقت کاملاً رایگان است. اگر بستهای حاوی عملکرد API خریداری کردهاید ، میتوانید خودتان کلید را در مرکز اعضا ← کلید API توسعهدهنده ایجاد کنید. هنگام فراخوانی با آن ، میتوانید از حد ذخیرهسازی و دوره نگهداری بسته مربوطه لذت ببرید.

نحوه حمل (یکی را انتخاب کنید)

نمونه درخواست

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"

به طور تصادفی یک آدرس ایمیل موقت ایجاد کنید. پس از تولید آدرس ، می توانید نامه را دریافت کنید و نیازی به فعال سازی از قبل نیست.

درخواست پارامترها

نمونه درخواست

curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"

نمونه پاسخ

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}

یک آدرس پیشوند سفارشی (پیشوند @ نام دامنه) را فعال کنید تا بررسی کنید که نام دامنه برای دریافت باز است یا خیر.

درخواست پارامترها

نمونه درخواست

curl -X POST "https://www.mail0.vip/mail/activate" \
  -d "address=mybox@ideciphera.com&ttl=60"

نمونه پاسخ

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}

صندوق ورودی آدرس مشخص شده را بکشید (50 آخرین ، به ترتیب معکوس زمان دریافت). توصیه می شود هر 1 تا 3 ثانیه یک بار نظرسنجی کنید.

درخواست پارامترها

نمونه درخواست

curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"

نمونه پاسخ

{
  "code": 1,
  "exists": 1,
  "address": "mybox@ideciphera.com",
  "list": [
    {
      "id": 1024,
      "from_addr": "noreply@example.com",
      "from_name": "Example",
      "subject": "Your verification code is 826413",
      "size": 2048,
      "is_read": 0,
      "attachments": 0,
      "received_at": "2026-10-14 18:20:31"
    }
  ]
}

مشاهده جزئیات پیام (فرستنده ، موضوع ، بدنه ، لیست پیوست ها). پیام پس از مشاهده به عنوان خوانده شده علامت گذاری می شود.

درخواست پارامترها

نمونه درخواست

curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"

نمونه پاسخ

{
  "code": 1,
  "data": {
    "id": 1024,
    "from_addr": "noreply@example.com",
    "from_name": "Example",
    "subject": "Your verification code is 826413",
    "body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
    "received_at_fmt": "2026-10-14 18:20:31",
    "attachments": [
      { "id": 88, "filename": "invoice.pdf", "size": 102400 }
    ]
  }
}

پیوست ایمیل را دانلود کنید (مستقیماً به جریان فایل برگردید ، نه JSON).

درخواست پارامترها

نمونه درخواست

curl -O "https://www.mail0.vip/mail/attach?id=88"

یک آدرس را برای مدت طولانی در حساب خود ذخیره کنید (لازم است وارد شوید یا کلید API خود را همراه داشته باشید) و تعداد آن مشمول محدودیت "ایمیل قابل ذخیره" بسته است.

درخواست پارامترها

نمونه درخواست

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"

آدرس های ایمیل ذخیره شده را در حساب خود فهرست کنید (لازم است وارد شوید یا کلید API را همراه داشته باشید).

نمونه درخواست

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"

اسکریپت زیر را می توان مستقیماً در کنسول مرورگر یا محیط Node اجرا کرد: ایجاد آدرس ، نظرسنجی از صندوق ورودی و چاپ کد تأیید پس از دریافت اولین ایمیل.

// 1. یک آدرس موقت ایجاد کنید
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('ایمیل موقت من:', address);

// 2. صندوق ورودی خود را نظرسنجی کنید (هر 2 ثانیه یکبار ، به محض دریافت اولین پیام متوقف می شود)
const seen = new Set();
while (true) {
  const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json();
  for (const m of d.list || []) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const code = (m.subject || '').match(/\d{4,8}/);
    console.log('ایمیل جدید:', m.subject, code ? 'کد تایید' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}