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"

درج ذیل اسکرپٹ براہ راست براؤزر کنسول یا نوڈ ماحول میں چلایا جا سکتا ہے: ایک پتہ تیار کریں ، اپنے ان باکس کو پول کریں ، اور پہلی ای میل موصول ہونے پر تصدیقی کوڈ پرنٹ کریں۔

// 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));
}