Documentazione API

Quando non si porta con sé la chiave, è possibile utilizzare l’API in modo anonimo. La generazione e la lettura di indirizzi email temporanei è completamente gratuita. Se hai acquistato un pacchetto che include funzionalità legate all’API, puoi generare la tua chiave direttamente nel centro dei membri → “API per sviluppatori”. Utilizzando questa chiave, potrai beneficiare delle opzioni offerte dal pacchetto acquistato.

Modalità di trasporto (selezionare una delle due opzioni)

Esempio di richiesta

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

Viene generata casualmente un indirizzo email temporaneo. Dopo la generazione dell’indirizzo, è possibile inviare messaggi senza dover attivarlo in anticipo.

Parametri richiesti

Esempio di richiesta

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

Esempio di risposta

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

Attivare un indirizzo con un prefisso personalizzato (prefisso@dominio), per verificare se il dominio è disponibile per la ricezione delle comunicazioni.

Parametri richiesti

Esempio di richiesta

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

Esempio di risposta

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

Ricerca nella casella di posta degli indirizzi specificati (i 50 messaggi più recenti, in ordine decrescente per data di ricezione). Si consiglia di effettuare l’interrogazione ogni 1–3 secondi.

Parametri richiesti

Esempio di richiesta

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

Esempio di risposta

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

Visualizza i dettagli dell’email (mittente, soggetto, corpo del messaggio, lista degli allegati). Dopo la visualizzazione, l’email viene marcata come letta.

Parametri richiesti

Esempio di richiesta

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

Esempio di risposta

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

Scaricare gli allegati delle email (ritorno diretto al flusso di file, non in formato JSON).

Parametri richiesti

Esempio di richiesta

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

Salva un indirizzo nel tuo account per una conservazione a lungo termine (è necessario effettuare l’accesso o utilizzare la chiave API). Il numero di indirizzi che possono essere salvati è limitato dalle condizioni del pacchetto offerto.

Parametri richiesti

Esempio di richiesta

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

Elenca gli indirizzi e-mail salvati nella tua account (è necessario effettuare l'accesso o utilizzare la chiave API per accedere).

Esempio di richiesta

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

Il seguente script può essere eseguito direttamente nella console del browser o nell’ambiente Node: genera l’indirizzo di accesso, effettua la polizia su la casella di posta in arrivo, e stampa il codice di verifica non appena riceve la prima email.

// 1. Creare un indirizzo temporaneo
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Il mio indirizzo email temporaneo:', address);

// 2. Polling della casella di posta in arrivo (una volta ogni 2 secondi, si interrompe non appena viene ricevuto il primo messaggio)
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('Nuove email:', m.subject, code ? 'Codice di verifica ' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}