API-documentatie

Als u geen sleutel bij u heeft, roept u anoniem op als bezoeker. Het genereren/lezen van tijdelijke mailboxen is volledig gratis. Als u een pakket met API-functies koopt, kunt u zelf een sleutel genereren in het Ledencentrum → Ontwikkelaar API-sleutel. Wanneer u deze gebruikt om te bellen, kunt u genieten van de opslaglimiet en retentieperiode van het overeenkomstige pakket.

Draagmethode (kies een van de twee)

Voorbeelden van aanvragen

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

Genereer willekeurig een tijdelijk e-mailadres. Ontvang brieven zodra het adres is gegenereerd, zonder vooraf activering.

Parameters aanvragen

Voorbeelden van aanvragen

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

Voorbeelden van reacties

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

Schakel een adres in met een aangepaste voorvoegsel (voorvoegsel @ domeinnaam) om te controleren of de domeinnaam open is voor ontvangst.

Parameters aanvragen

Voorbeelden van aanvragen

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

Voorbeelden van reacties

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

Haal de inbox van het opgegeven adres (de laatste 50, in omgekeerde volgorde van ontvangsttijd). Het wordt aanbevolen om elke 1 tot 3 seconden te pollen.

Parameters aanvragen

Voorbeelden van aanvragen

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

Voorbeelden van reacties

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

Bekijk de details van het bericht (afzender, onderwerp, lichaam, lijst met bijlagen). Berichten worden na het bekijken als gelezen gemarkeerd.

Parameters aanvragen

Voorbeelden van aanvragen

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

Voorbeelden van reacties

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

Download de e-mailbijlage (retourneer rechtstreeks naar de bestandsstroom, niet JSON).

Parameters aanvragen

Voorbeelden van aanvragen

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

Sla een adres op in uw account voor lange tijd (u moet inloggen of een API-sleutel meenemen), en het aantal is onderworpen aan de limiet "opslaanbare e-mailboxen" van het pakket.

Parameters aanvragen

Voorbeelden van aanvragen

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

Maak een lijst van de opgeslagen e-mailadressen onder uw account (u moet inloggen of een API-sleutel meenemen).

Voorbeelden van aanvragen

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

Het volgende script kan rechtstreeks in de browserconsole of Node-omgeving worden uitgevoerd: het genereren van adressen, het pollen van de inbox en het afdrukken van verificatiecodes bij ontvangst van de eerste e-mail.

// 1. Genereer een tijdelijk adres
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Mijn tijdelijke e-mail:', address);

// 2. Poll uw inbox (elke 2 seconden, stop zodra u het eerste bericht ontvangt)
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('Nieuwe e-mail:', m.subject, code ? 'Verificatiecode' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}