címlap Csomagok API-dokumentáció GYIK Szakma generátor Személyazonosító generátor Cím generátor

API dokumentáció

Használja a HTTP interfészt ideiglenes postafiók létrehozásához, e-mailek fogadásához és a fogadási képességek integrálásához saját szkriptjeibe, tesztcsővezetékeibe vagy robotjaiba.

Interfész báziscímhttps://www.mail0.vip Minden végpont JSON-t ad vissza (kivéve melléklet letöltés). A vendégek névtelenül hívhatnak; az API-t tartalmazó csomagot vásárlók API-kulccsal is hívhatnak a saját fiókjuk nevében (a csomag kvótáival) — lásd az „API-kulcs hitelesítés” részt lent.
KEY API-kulcs hitelesítés (opcionális, híváshoz a fiók nevében)

Kulcs nélkül a hívások névtelenek, és az ideiglenes postafiókok létrehozása és olvasása teljesen ingyenes. Ha API-t tartalmazó csomagot vásárolt, a tagközpontban → Fejlesztői API-kulcs alatt saját kulcsot hozhat létre, és a csomagja mentési kvótáját és megőrzési idejét használhatja.

Küldés módja (a kettő egyike)

útPélda
URL-paraméter?key=YOUR_API_KEY
KérésfejlécX-API-Key: YOUR_API_KEY

Példa a kérésre

curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"
hiba:Ha a kulcs érvénytelen vagy ki van kapcsolva, a végpont hibakódot ad vissza; figyelje a msg mezőt. Őrizze meg a kulcsot biztonságosan, és soha ne tegye frontend-kódba vagy nyilvános tárolóba.
GET /mail/gen

Véletlenszerűen generáljon ideiglenes e-mail címet. A levél a cím generálása után fogadható, előzetes aktiválás nélkül.

Paraméterek kérése

paramétertípusKötelezőillusztráljon
domainstring否Adja meg a domain nevet, ha nem adja át, használja a webhely alapértelmezett domain nevét
ttlint否Az átvétel érvényességi ideje (perc), opcionális 10/30/60/1440. Nem adja át az alapértelmezett 10. A konkrét választásokat a csomag "Levél érvényességi engedélye" határozza meg. Ha túllépi az engedélyt, a kód = -101-et adja vissza

Példa a kérésre

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

Válaszpélda

{
  "code": 1,
  "address": "k3j8fh2ma@ideciphera.com"
}
tipp:A ttl lehet 10 / 30 / 60 / 1440 (perc), alapértelmezés 10; az elérhető választások a csomag „fogadási érvényességétől” függenek, azon túl code=-101 érkezik vissza.
POST /mail/activate

Engedélyezze az egyéni előtagú címet (előtag @ domain név) annak ellenőrzéséhez, hogy a domain név nyitva áll-e a fogadásra.

Paraméterek kérése

paramétertípusKötelezőillusztráljon
addressstring是Teljes e-mail cím, például mybox@mail0.vip
ttlint否Érvényességi idő (perc), opcionális 10/30/60/1440, a szabályok ugyanazok, mint a/mail/gen

Példa a kérésre

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

Válaszpélda

{
  "code": 1,
  "address": "mybox@ideciphera.com"
}
hiba:Ha kód =0, az üzenet „Hibás e-mail formátum "vagy „A domain név nem nyitva áll a fogadásra"; code = -101 azt jelzi, hogy a kiválasztott érvényességi idő túllépte a csomag engedélyeit.
GET /mail/inbox

Húzza ki a megadott cím postaládáját (az utolsó 50 üzenet, fordított sorrendben a fogadási idő szerint). Javasoljuk, hogy 1-3 másodpercenként szavazzon.

Paraméterek kérése

paramétertípusKötelezőillusztráljon
addressstring是Érdeklődni kívánt e-mail cím

Példa a kérésre

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

Válaszpélda

{
  "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"
    }
  ]
}
tipp:exists =0 azt jelenti, hogy a cím nem kapott levelet (maga a cím még mindig elérhető). A JS-ben a list []. id használatával eltávolíthatja a duplikációt, hogy elérje a „csak új e-mailek feldolgozását ".
GET /mail/view

Az üzenet részleteinek megtekintése (feladó, tárgy, test, mellékletek listája). Az üzenet megtekintése után olvasottként van megjelölve.

Paraméterek kérése

paramétertípusKötelezőillusztráljon
addressstring是E-mail cím (a tulajdonjog ellenőrzésére szolgál)
idint是Üzenet azonosító (a postaládák listájából származó azonosító)

Példa a kérésre

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

Válaszpélda

{
  "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 }
    ]
  }
}
GET /mail/attach

Töltse le az e-mail mellékletét (közvetlenül a fájlfolyamhoz, nem JSON-hoz).

Paraméterek kérése

paramétertípusKötelezőillusztráljon
idint是Melléklet azonosító (attachments []. id az e-mail részleteiből)

Példa a kérésre

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

Mentse el egy címet hosszú távon a fiókjába (bejelentkezés vagy API-kulcs szükséges); a számot a csomag „menthető postafiókok” kvótája korlátozza.

Paraméterek kérése

paramétertípusKötelezőillusztráljon
addressstring是Mentendő e-mail cím
keystring否API kulcs (nem szükséges a bejelentkezett weboldalakhoz)

Példa a kérésre

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

A fiókjába mentett postafiókok listája (bejelentkezés vagy API-kulcs szükséges).

Példa a kérésre

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"
JS Teljes példa: Cím generálása → Kaptcha e-mail várakozása

A következő parancsfájl közvetlenül a böngészőkonzolon vagy a Node környezetben futtatható: címek létrehozása, a postafiók lekérdezése és az ellenőrző kód kinyomtatása az első e-mail kézhezvételekor.

// 1. Hozzon létre ideiglenes címet
const BASE = 'https://www.mail0.vip';
const gen = await (await fetch(BASE + '/mail/gen')).json();
const address = gen.address;
console.log('Ideiglenes e-mail címem:', address);

// 2. Lekérdezze a postafiókot (2 másodpercenként, leáll az első üzenet kézhezvétele után)
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('Új e-mail:', m.subject, code ? 'Ellenőrző kód' + code[0] : '');
  }
  await new Promise(r => setTimeout(r, 2000));
}
Megjegyzés:Az ideiglenes e-mail címe nyilvánosan olvasható, kérjük, ne használja érzékeny információk fogadására; A levél lejárta után automatikusan megtisztítja.
! Használati utasítások és korlátozások
projektillusztráljon
HitelkeretMinden címnek napi beérkezési limitje van (napi 30 ingyenes, tagoknak még magasabb), és az új leveleket elutasítják, ha túllépi azokat
E-mail fenntartásAz e-mailek automatikusan törlődnek a csomag megőrzési ideje szerint (7 nap ingyenes, 30/90 nap tagok számára), kérjük, időben gyűjtsék össze
A szavazás gyakoriságaJavasoljuk, hogy 1-3 másodpercenként egyszer lekérdezze ugyanazt a címet
A levél érvényességi idejeA cím érvényességi idejét a ttl paraméter határozza meg, és az opcionális időtartamot a csomag "fogadó érvényességi engedélye" szabályozza (az ingyenes csomag alapértelmezés szerint csak 10 perc); A lejárat után a cím már nem fogad levelet, és a "Mentse ezt a postafiókot" hosszú ideig megőrizhető
Cím adatvédelemAz ideiglenes postafiók a cím szerint nyilvánosan olvashatók, és bárki, aki ismeri a címet, megtekintheti az e-maileket
Hibás formátumHa sikertelen, adja vissza a {"code": 0, "msg": "reason"} -ot, a siker pedig a code =1; kód = -100 azt jelenti, hogy nincs bejelentkezve, vagy az API kulcs érvénytelen, kód = -101 azt jelenti, hogy a kiválasztott érvényességi idő túllépte a csomag engedélyeit

Súgóközpont

További használati tippeket és gyakran ismételt kérdéseket egy cikk egyértelműen elmagyarázza

Hogyan lehet ezt az oldalt ideiglenes e-mail címek létrehozására használni?

Nyissa meg a kezdőlapot és kattintson a "E-mail frissítése" gombra, hogy egy kattintással létrehozzon egy véletlenszerű ideiglenes címet, vagy testreszabhatja az előtagot és a domain nevet.

Bővebben →

Mi az ideiglenes postafiók?

Az ideiglenes/eldobható e-mail egy regisztrációmentes, eldobható e-mail cím, amelyet ellenőrző kódok és ideiglenes e-mailek fogadására használnak.

Bővebben →

Hogyan menthetem el a postaládámat, hogy hosszabb ideig kaphassak e-maileket?

Kattintson a "E-mail mentése" gombra, hogy a címet hosszú távú címre konvertálja, és jelentkezzen be a tagközpontba az egységes kezeléshez.

Bővebben →

Hogyan másolhatom le az e-mail címemet és regisztrálhatok más weboldalakon?

Kattintson a "Másolás" gombra a címsávon, és illessze be a címet a célwebhely e-mail beviteli mezőjébe a regisztráció befejezéséhez.

Bővebben →

Mi a különbség az ideiglenes postafiók és a normál postafiók között (Gmail/QQ stb.)?

Az ideiglenes postafiók névtelenek és eldobhatók, személyazonosság nélkül; A rendszeres e-mail címeket hosszú ideig tartják, regisztrálni kell, és visszakereshetők. A kettő elhelyezése eltérő.

Bővebben →

Miért nem kapok ellenőrző kódot vagy e-mailt?

A nem kapott e-mailek többnyire azért vannak, mert a cím lejárt, a szállítás késik, vagy a webhely blokkolja az ideiglenes e-mail domain nevet. Az érvényességi időn belül frissítheti vagy megváltoztathatja a domain nevet, és újra próbálkozhat.

Bővebben →

Barátságos linkek

Szolgáltatások Iparági linkek