مستندات 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));
}