API-Dokumentation

Wenn Sie keine API-Schlüssel dabei haben, können Sie anonym aufgerufen werden. Die Erstellung und Lesung von temporären E-Mails ist vollständig kostenlos. Wenn Sie ein Paket mit API-Funktionen gekauft haben, können Sie im Mitgliedereinsatzbereich den Schlüssel selbst erzeugen. Mit diesem Schlüssel können Sie die entsprechenden Vorteile des Pakets nutzen – wie beispielsweise die Speicherkapazität und die Aufbewahrungsfrist für Ihre Daten.

Trägermethoden (wählen Sie eine von zwei Möglichkeiten)

Beispiel für eine Anfrage

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

Eine zufällig generierte temporäre E-Mail-Adresse wird bereitgestellt. Die Adresse kann sofort verwendet werden, ohne dass vorher eine Aktivierung erforderlich ist.

Anforderungsparameter

Beispiel für eine Anfrage

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

Antwortbeispiel

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

Verwenden Sie eine Adresse mit benutzerdefiniertem Präfix (Präfix@Domainnamen). Überprüfen Sie anschließend, ob die Domain für Empfänger freigegeben ist.

Anforderungsparameter

Beispiel für eine Anfrage

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

Antwortbeispiel

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

Laden der Posteingang an der angegebenen Adresse (die letzten 50 E-Mails, in umgekehrter Reihenfolge nach Empfangszeit). Es wird empfohlen, alle 1 bis 3 Sekunden zu überprüfen.

Anforderungsparameter

Beispiel für eine Anfrage

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

Antwortbeispiel

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

Sie können die Details der E-Mail ansehen: Absender, Betreff, Inhalt sowie die Liste der Anhänge. Nach dem Ansehen wird die E-Mail als gelesen markiert.

Anforderungsparameter

Beispiel für eine Anfrage

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

Antwortbeispiel

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

Laden Sie E-Mail-Anhänge herunter (kehren Sie direkt in den Dateiflow zurück, nicht in JSON).

Anforderungsparameter

Beispiel für eine Anfrage

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

Eine Adresse kann auf Ihrem Konto gespeichert werden, um sie langfristig zu speichern – dies ist nur möglich, wenn Sie sich angemeldet haben oder eine API-Schlüssel besitzen. Die Anzahl der gespeicherten Adressen wird durch die Obergrenze des „Speichern von E-Mails“-Pakets begrenzt.

Anforderungsparameter

Beispiel für eine Anfrage

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

Bitte listet die bereits gespeicherten E-Mail-Adressen unter Ihrer Accountstruktur auf – dazu müssen Sie sich anmelden oder den API-Schlüssel bereitstellen.

Beispiel für eine Anfrage

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

Der folgende Skript kann direkt in der Browser-Konsole oder im Node.js-Umfeld ausgeführt werden: Erzeugung einer Adresse, Abfrage der Posteingangsbucht, Ausgabe des Verifizierungscodes, sobald das erste E-Mail-Ereignis eintritt.

// 1. Erstellen eines vorübergehenden Adresses
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Mein vorübergehendes E-Mail-Konto:', address);

// 2. Abfrage der Nachrichtendatei (jedensieben Sekunden, beendet, sobald die erste Nachricht angekommen ist)
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('Neue E-Mails:', m.subject, code ? 'Verifikationscode' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}