Documentație API

Când nu purtați cheia, apelați anonim ca vizitator și generați/citiți o cutie poștală temporară complet gratuită. Dacă achiziționați un pachet care conține funcții API, puteți genera singur cheia în Centrul pentru membri → Cheia API pentru dezvoltator Când îl utilizați pentru a apela, vă puteți bucura de limita de salvare și perioada de reținere a pachetului corespunzător.

Metoda de transport (alegeți una dintre cele două)

Exemplu de solicitare

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

Generați aleatoriu o adresă de e-mail temporară. Scrisoarea poate fi primită după ce adresa este generată, fără preactivare.

Solicitați parametrii

Exemplu de solicitare

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

Exemplu de răspuns

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

Activați o adresă de prefix personalizat (prefix @ nume de domeniu) pentru a verifica dacă numele de domeniu este deschis pentru primire.

Solicitați parametrii

Exemplu de solicitare

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

Exemplu de răspuns

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

Trageți căsuța de e-mail a adresei specificate (ultimele 50, în ordinea inversă a timpului de primire). Se recomandă să sondați o dată la 1 până la 3 secunde.

Solicitați parametrii

Exemplu de solicitare

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

Exemplu de răspuns

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

Vizualizați detaliile mesajului (expeditor, subiect, corp, listă de atașamente). Mesajul este marcat ca citit după vizualizare.

Solicitați parametrii

Exemplu de solicitare

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

Exemplu de răspuns

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

Descărcați atașamentul de e-mail (returnați direct fluxul de fișiere, nu JSON).

Solicitați parametrii

Exemplu de solicitare

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

Salvați o adresă în contul dvs. pentru o perioadă lungă de timp (trebuie să vă conectați sau să aduceți o cheie API).

Solicitați parametrii

Exemplu de solicitare

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

Listați adresele de e-mail salvate sub contul dvs. (trebuie să vă conectați sau să aduceți cheia API).

Exemplu de solicitare

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

Următorul script poate fi rulat direct în consola browserului sau în mediul Node: generați o adresă, interogați căsuța de e-mail și imprimați un cod de verificare la primirea primului e-mail.

// 1. Generați o adresă temporară
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('E-mailul meu temporar:', address);

// 2. Sondați căsuța de e-mail (la fiecare 2 secunde, opriți-vă imediat ce primiți primul mesaj)
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('E-mail nou:', m.subject, code ? 'Cod de verificare' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}