Nyaraka za API

Unapobeba ufunguo, piga simu bila kujulikana na mgeni, na kuzalisha/kusoma sanduku la barua la muda ni bure kabisa. Ukinunua kifurushi kilicho na utendakazi wa API, unaweza kujitengenezea ufunguo katika Kituo cha Wanachama → Ufunguo wa API ya Wasanidi Programu Unapoitumia kupiga simu, unaweza kufurahia kikomo cha kuhifadhi na muda wa kuhifadhi wa kifurushi kinacholingana.

Njia ya kubeba (chagua moja ya mbili)

Mfano wa ombi

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

Tengeneza anwani ya barua pepe ya muda bila mpangilio. Barua zinaweza kupokelewa baada ya anwani kuzalishwa bila kuwezesha mapema.

Vigezo vya ombi

Mfano wa ombi

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

Mfano wa majibu

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

Washa anwani ya awali ya desturi (prefix @ jina la kikoa) ili kuthibitisha kama jina la kikoa limefunguliwa kwa mapokezi.

Vigezo vya ombi

Mfano wa ombi

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

Mfano wa majibu

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

Vuta kikasha cha anwani maalum (50 za mwisho, kwa utaratibu wa nyuma kulingana na wakati wa kupokea). Inashauriwa kupiga kura kila baada ya sekunde 1 hadi 3.

Vigezo vya ombi

Mfano wa ombi

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

Mfano wa majibu

{
  "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"
    }
  ]
}

Angalia maelezo ya barua pepe (mtumaji, mada, mwili, orodha ya viambatisho). Ujumbe umewekwa alama kama umesomwa baada ya kutazama.

Vigezo vya ombi

Mfano wa ombi

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

Mfano wa majibu

{
  "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 }
    ]
  }
}

Pakua viambatisho vya barua pepe (kurudi moja kwa moja kwenye mkondo wa faili, sio JSON).

Vigezo vya ombi

Mfano wa ombi

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

Hifadhi anwani kwenye akaunti yako kwa uhifadhi wa muda mrefu (unahitaji kuingia au kubeba Ufunguo wa API), na idadi hiyo inategemea kikomo cha kifurushi cha "barua pepe inayoweza kuhifadhiwa".

Vigezo vya ombi

Mfano wa ombi

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

Orodhesha anwani za barua pepe zilizohifadhiwa chini ya akaunti yako (unahitaji kuingia au kubeba Ufunguo wa API).

Mfano wa ombi

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

Hati ifuatayo inaweza kuendeshwa moja kwa moja kwenye kiweko cha kivinjari au mazingira ya Node: kuzalisha anwani, kupiga kura kwenye kikasha chako, na kuchapisha msimbo wa uthibitishaji baada ya kupokea barua pepe ya kwanza.

// 1. Tengeneza anwani ya muda
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Barua pepe yangu ya muda:', address);

// 2. Piga kura kwenye kikasha chako (kila baada ya sekunde 2, itasimama mara tu barua ya kwanza inapopokelewa)
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('Barua mpya:', m.subject, code ? 'Msimbo wa uthibitishaji' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}