TempMail API Dokumentáció

REST API v1 és Webhookok

TempMailg Fejlesztői API dokumentáció

Használja ezt a dokumentációt, hogy létrehozza a személyes API-kulcsát, csatlakozzon a dedikált felhasználói API-hoszthoz, olvassa a postaláda üzeneteit, kezelje a saját postaládáit, és integrálja a Temp Mailt a saját alkalmazásaiba vagy automatizálásába.

Bearer token hitelesítés Valós idejű webhookok Gmail & Outlook álnevek JSON válaszok
Felhasználói API Alap URL HTTPS
Kérés formátuma Használja az API-kulcsát csak az Authorization Bearer fejlécben, és tartsa tisztán a végpont URL-eket.

Postafiók kezelése

Lekérdezni a megengedett domaineket, létrehozni vagy átváltani a postafiókokat, kiválasztani a megengedett élettartamokat, és törölni a tulajdonolt címeket.

GET https://v1.tempmailg.com/api/domains?type={type}
#

Engedélyezett domainek listája

Listázza a rendelkezésre álló domaineket ideiglenes e-mailek létrehozásához. Szűrj típus szerint, hogy csak a feliratkozási csomagod által támogatott ingyenes, prémium vagy egyedi domaineket lásd.

Paraméterek 1
Paraméter Hely Típus Állapot Leírás
type query string opcionális
Domain szint szűrő. Ha kihagyja, az összeset használja, amikor a prémium-domain hozzáférés engedélyezve van, egyébként ingyenes. Felismert értékek: free, basic, pro, premium, custom, ultimate, all
Alapértelmezett: Fióktól függő
Engedélyezett domainek lekérése
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "data": {
        "requested_type": "free",
        "plan": "pro",
        "plan_name": "Pro Plan",
        "allowed_types": [
            "free",
            "basic",
            "pro",
            "premium",
            "custom",
            "ultimate",
            "all"
        ],
        "domains": [
            {
                "domain": "example.com",
                "type": "Free",
                "custom": false
            }
        ]
    }
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
data.requested_type string
Alkalmazott domain szűrő.
data.plan string
Aktuális tervcímke.
data.plan_name string
Olvasható név a jelenlegi csomagról.
data.allowed_types array<string>
A fiókhoz elérhető domain szűrők. Egy felismert szűrő továbbra is tiltott lehet a csomagjában.
data.domains array
A szűrés után választható domainek; egy üres tömb érvényes.
data.domains[].domain string
Választható domain név.
data.domains[].type string
Olvasható domain szint címke.
data.domains[].custom boolean
Ez egy egyéni domain-e.
POST https://v1.tempmailg.com/api/emails
#

Ideiglenes postafiók létrehozása

Hozzon létre egy saját ideiglenes postafiókot. Hagyja ki a felhasználónevet és a domaint a véletlenszerű generáláshoz, vagy adjon meg egy engedélyezett egyéni felhasználónevet és egy megengedett domaint. A provider paraméter kiválaszthatja a Gmail vagy Outlook alias generálást.

Paraméterek 8
Paraméter Hely Típus Állapot Leírás
username body string opcionális
Opcionális egyéni felhasználónév: 2‑tól 64‑ig ASCII betű, szám, pont, aláhúzás vagy kötőjel. Csomagengedély szükséges; a custom_username is elfogadott.
Alapértelmezett: Véletlenszerűen generált
domain body string opcionális
Az engedélyezett tartományok egyike, amelyet a GET /domains visszaad. A kihagyás egy véletlenszerű engedélyezett tartományt választ.
Alapértelmezett: Véletlenszerű engedélyezett domain
lifetime body string opcionális
engedélyezett értékek:
10m — 10 perc 1h — 1 Óra 2h — 2 Óra 1d — 1 nap 1w — 1 Hét 1m — 30 Nap 3m — 90 nap 6m — 180 nap 1y — 365 nap unlimited — Korlátlan
Alapértelmezett: A terv alapértelmezett élettartama
provider body string opcionális
Postafiók szolgáltató: standard, gmail_alias vagy outlook_alias.
Alapértelmezett: standard
pin_enabled body boolean opcionális
Opcionális PIN védelem az új postafiókhoz, ha a csomagja engedélyezi. Nem változtatja meg a meglévő postafiók PIN-kódját.
Alapértelmezett: false
pin body string opcionális
Szükséges, ha a pin_enabled igaz: egy 6‑8 számjegyből álló PIN, karakterláncként küldve a vezető nullák megőrzése érdekében.
pin_confirmation body string opcionális
Szükséges, ha a pin_enabled igaz. Pontosan meg kell egyeznie a pin-nel.
Idempotency-Key header string opcionális
PIN-védelemmel ellátott létrehozáshoz vagy törléshez szükséges: egy stabil, 16‑tól 128‑ig karakteres kulcs. Ismételd meg ugyanazt a kérést ugyanazzal a kulccsal a duplikált munka elkerülése érdekében.
Opcionális törzsparaméterek: username (egyéni felhasználónév, ha a csomag engedélyezi), domain (engedélyezett domain, pl. example.com), lifetime (engedélyezett értékek: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Hagyja ki az élettartamot, vagy hagyja üresen, hogy a jelenlegi havi/éves csomaghoz beállított Alapértelmezett E-mail Élettartamot használja. Küldjön egy engedélyezett élettartamot, például 1h, hogy felülírja az alapértelmezettet. A korlátlan csak akkor használható, ha a csomag alapértelmezéseként van beállítva, vagy kifejezetten kérik és engedélyezik. A body paraméterek, a mailbox_lifetime és az email_lifetime is elfogadottak; az első nem üres érték nyer ebben a sorrendben: lifetime, mailbox_lifetime, email_lifetime. Az érvénytelen vagy tiltott értékek HTTP 422-t adnak vissza ahelyett, hogy csendben egy alapértelmezettet választanának.
Postafiók létrehozása
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2301,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-20T02:18:20+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:20+00:00",
        "email_token": "encrypted-email-token"
    }
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
data.id integer
Postafiók azonosító. A generált azonosítók, címek és tokenek minden postafióknál eltérnek.
data.pin_protected boolean
Megadja, hogy ez a postafiók PIN védelemmel rendelkezik-e. PIN vagy PIN hash nem kerül visszaadásra.
data.email string
Teljes postafiócím generálva.
data.domain string
A létrehozott postafiók domainje.
data.provider string
Postafiók szolgáltató: standard, gmail_alias vagy outlook_alias.
data.expire_at string|null
Érvényes lejárat ISO-8601 időbélyegként, vagy null egy korlátlan postafiók esetén.
data.expires_in_seconds number|null
Nem negatív másodpercek maradnak a számításkor; tört másodpercek is lehetségesek. A null korlátlan, nem nulla.
data.mailbox_state string
A jelenlegi postafiók állapota: aktív, szüneteltetett, lejárt vagy inaktív.
data.receiving_enabled boolean
Az, hogy ez a postafiók jelenleg elfogadja-e a bejövő üzeneteket.
data.message_count integer
Ismert összes üzenetszám; tükrözheti az utolsó postafiók szinkronizálást.
data.unread_message_count integer
Ismert olvasatlan üzenetek száma; tükrözheti az utolsó postafiók szinkronizálását.
data.last_message_received_at string|null
Az utolsó ismert fogadott üzenet időpontja ISO-8601 formátumban, vagy null, ha nem érhető el.
data.message_count_synced_at string|null
Az utolsó üzenetszám-szinkronizálás időpontja ISO-8601 formátumban, vagy null, ha a szinkronizáció előtt.
data.created_at string|null
A postafiók létrehozásának időpontja ISO-8601 formátumban.
data.email_token string
Átlátszatlan titkosított postafiók hivatkozás. Nem helyettesíti a Bearer hitelesítést, a tulajdonjog ellenőrzéseket vagy a PIN engedélyezést.
data.pin_grant object
Feltételes: az aktív PIN-védelemmel ellátott postafiók létrehozása visszaadja ezt az olvasási engedélyt; a szokásos, védtelen létrehozás kihagyja azt.
data.pin_grant.mailbox_id integer
Postafiók-azonosító, amelyhez a feltételes olvasási engedély kötve van.
data.pin_grant.unlock_token string
Átlátszatlan olvasási token az X-Mailbox-Unlock-hoz ugyanazzal a tulajdonosi hitelesítővel. Tartsd privátban és memóriában; egy olvasási engedély nem jogosít fel törlésre.
data.pin_grant.scope string
A feltételes létrehozási engedély hatókörének olvasása.
data.pin_grant.idle_timeout_seconds integer
A olvasási engedélyhez megengedett üresjárati idő, általában 3600 másodperc.
data.pin_grant.absolute_timeout_seconds integer
Az olvasási engedély maximális élettartama, általában 86400 másodperc.
data.pin_grant.expires_at string
A jelenlegi olvasási jogosultság lejárata ISO-8601 formátumban.
data.pin_grant.absolute_expires_at string
Abszolút olvasási engedély lejárata ISO-8601 formátumban. A biztonsági változások korábban visszavonhatják az engedélyt.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Postafiók frissítése / váltás

Hozzon létre vagy válasszon egy postafiókot az új felhasználónév és domain alatt, miután ellenőrizte a jelenlegi postafiók tulajdonjogát. Ez nem nevez át a régi postafiókot, és nem változtatja meg annak élettartamát. Ha a cél eltér, a régi postafiók a történetben marad, és az aktív postafiók korlátok miatt szüneteltethető. Saját aktív cél újrahasználata visszaállítja a kért élettartamot vagy az alapértelmezett tervet.

Paraméterek 9
Paraméter Hely Típus Állapot Leírás
email path string kötelező
A tulajdonolt postafiók jelenlegi teljes e-mail címe a váltáshoz. URL-kódolja minden útvonal szegmensét; a plusz jelet %2B‑ként kódolja.
username path string kötelező
Új kívánt felhasználónév: 2‑tól 64‑ig alfanumerikus karakter, egyéni felhasználónév engedélytől függően.
domain path string kötelező
Új engedélyezett domain név.
lifetime body string opcionális
engedélyezett értékek:
10m — 10 perc 1h — 1 Óra 2h — 2 Óra 1d — 1 nap 1w — 1 Hét 1m — 30 Nap 3m — 90 nap 6m — 180 nap 1y — 365 nap unlimited — Korlátlan
Alapértelmezett: A terv alapértelmezett élettartama
pin_enabled body boolean opcionális
Opcionális PIN védelem az új postafiókhoz, ha a csomagja engedélyezi. Nem változtatja meg a meglévő postafiók PIN-kódját.
Alapértelmezett: false
pin body string opcionális
Szükséges, ha a pin_enabled igaz: egy 6‑8 számjegyből álló PIN, karakterláncként küldve a vezető nullák megőrzése érdekében.
pin_confirmation body string opcionális
Szükséges, ha a pin_enabled igaz. Pontosan meg kell egyeznie a pin-nel.
Idempotency-Key header string opcionális
PIN-védelemmel ellátott létrehozáshoz vagy törléshez szükséges: egy stabil, 16‑tól 128‑ig karakteres kulcs. Ismételd meg ugyanazt a kérést ugyanazzal a kulccsal a duplikált munka elkerülése érdekében.
X-Mailbox-Unlock header string opcionális
Fejléc, csak védett postafiókok: használjon read unlock_token-t. Először POST-oljon pin és scope=read a PIN feloldási URL-re. Tartsa meg a szokásos Bearer hitelesítést. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Használja a meglévő saját postaláda e-mail címét a {email} mezőben. Opcionális body paraméter: lifetime (engedélyezett értékek: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Hagyja ki az élettartamot, vagy hagyja üresen, hogy a jelenlegi havi/éves csomaghoz beállított Alapértelmezett E-mail Élettartamot használja. Küldjön egy engedélyezett élettartamot, például 1h, hogy felülírja az alapértelmezettet. A korlátlan csak akkor használható, ha a csomag alapértelmezéseként van beállítva, vagy kifejezetten kérik és engedélyezik. A body paraméterek, a mailbox_lifetime és az email_lifetime is elfogadottak; az első nem üres érték nyer ebben a sorrendben: lifetime, mailbox_lifetime, email_lifetime. Az érvénytelen vagy tiltott értékek HTTP 422-t adnak vissza ahelyett, hogy csendben egy alapértelmezettet választanának.
Saját postaláda frissítése
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2302,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-19T02:28:20+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:20+00:00",
        "email_token": "encrypted-email-token"
    }
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
data.id integer
Postafiók azonosító. A generált azonosítók, címek és tokenek minden postafióknál eltérnek.
data.pin_protected boolean
Megadja, hogy ez a postafiók PIN védelemmel rendelkezik-e. PIN vagy PIN hash nem kerül visszaadásra.
data.email string
Teljes postafiócím generálva.
data.domain string
A létrehozott postafiók domainje.
data.provider string
Postafiók szolgáltató: standard, gmail_alias vagy outlook_alias.
data.expire_at string|null
Érvényes lejárat ISO-8601 időbélyegként, vagy null egy korlátlan postafiók esetén.
data.expires_in_seconds number|null
Nem negatív másodpercek maradnak a számításkor; tört másodpercek is lehetségesek. A null korlátlan, nem nulla.
data.mailbox_state string
A jelenlegi postafiók állapota: aktív, szüneteltetett, lejárt vagy inaktív.
data.receiving_enabled boolean
Az, hogy ez a postafiók jelenleg elfogadja-e a bejövő üzeneteket.
data.message_count integer
Ismert összes üzenetszám; tükrözheti az utolsó postafiók szinkronizálást.
data.unread_message_count integer
Ismert olvasatlan üzenetek száma; tükrözheti az utolsó postafiók szinkronizálását.
data.last_message_received_at string|null
Az utolsó ismert fogadott üzenet időpontja ISO-8601 formátumban, vagy null, ha nem érhető el.
data.message_count_synced_at string|null
Az utolsó üzenetszám-szinkronizálás időpontja ISO-8601 formátumban, vagy null, ha a szinkronizáció előtt.
data.created_at string|null
A postafiók létrehozásának időpontja ISO-8601 formátumban.
data.email_token string
Átlátszatlan titkosított postafiók hivatkozás. Nem helyettesíti a Bearer hitelesítést, a tulajdonjog ellenőrzéseket vagy a PIN engedélyezést.
data.pin_grant object
Feltételes: az aktív PIN-védelemmel ellátott postafiók létrehozása visszaadja ezt az olvasási engedélyt; a szokásos, védtelen létrehozás kihagyja azt.
data.pin_grant.mailbox_id integer
Postafiók-azonosító, amelyhez a feltételes olvasási engedély kötve van.
data.pin_grant.unlock_token string
Átlátszatlan olvasási token az X-Mailbox-Unlock-hoz ugyanazzal a tulajdonosi hitelesítővel. Tartsd privátban és memóriában; egy olvasási engedély nem jogosít fel törlésre.
data.pin_grant.scope string
A feltételes létrehozási engedély hatókörének olvasása.
data.pin_grant.idle_timeout_seconds integer
A olvasási engedélyhez megengedett üresjárati idő, általában 3600 másodperc.
data.pin_grant.absolute_timeout_seconds integer
Az olvasási engedély maximális élettartama, általában 86400 másodperc.
data.pin_grant.expires_at string
A jelenlegi olvasási jogosultság lejárata ISO-8601 formátumban.
data.pin_grant.absolute_expires_at string
Abszolút olvasási engedély lejárata ISO-8601 formátumban. A biztonsági változások korábban visszavonhatják az engedélyt.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Postafiók törlése

Törölje a tulajdonolt postafiókot, és indítsa el az üzenetek és fájlok tisztítását. A megtartott postafiók rekordok belsőleg lágyan törölhetők; a cím már nem használható az API-n keresztül.

Paraméterek 3
Paraméter Hely Típus Állapot Leírás
email path string kötelező
A törlendő saját postafiók teljes e-mail címe. URL-kódolja a címet; a plusz jelet kódolja %2B‑ként.
X-Mailbox-Unlock header string opcionális
Fejléc, csak védett postafiókok esetén: használja az egyszeri törléshez szánt unlock_token-t. Először POST pin, scope=delete és a 423 válaszban visszaadott action/target_id a PIN feloldási URL-hez. Egy olvasási token nem tud törölni. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opcionális
PIN-védelemmel ellátott létrehozáshoz vagy törléshez szükséges: egy stabil, 16‑tól 128‑ig karakteres kulcs. Ismételd meg ugyanazt a kérést ugyanazzal a kulccsal a duplikált munka elkerülése érdekében.
Saját postaláda törlése
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
message string
A törlés eredménye. Hiányzó erőforrás esetén HTTP 404-et ad vissza.

Gmail & Outlook álnevek

Generáljon magas hírű Gmail és Outlook/Hotmail alias postafiókokat.

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Gmail alias létrehozása

Hozzon létre egy új Gmail alias ideiglenes postafiókot, amely a hitelesített felhasználóhoz tartozik.

Paraméterek 8
Paraméter Hely Típus Állapot Leírás
mode body string opcionális
Generálási mód: auto, dot, plus vagy plus_dot. Elfogadja a gmail_alias_mode-ot is. Ha a stílus kiválasztása nem engedélyezett, az auto kerül használatra.
Alapértelmezett: auto
username body string opcionális
Opcionális egyéni alias utótag: 2-tól 32-ig ASCII betű vagy szám, kisbetűre normalizálva; a funkció engedélyétől függ. Elfogadja a custom_username vagy alias_username értékeket is.
Alapértelmezett: Automatikusan generált
domain body string opcionális
Használjon véletlenszerűt, gmail.com-ot vagy googlemail.com-ot; az alias_domain is elfogadott. A kihagyás vagy a nem elérhető domain-kiválasztási engedély véletlenszerűt használ.
Alapértelmezett: random
lifetime body string opcionális
engedélyezett értékek:
10m — 10 perc 1h — 1 Óra 2h — 2 Óra 1d — 1 nap 1w — 1 Hét 1m — 30 Nap 3m — 90 nap 6m — 180 nap 1y — 365 nap unlimited — Korlátlan
Alapértelmezett: A terv alapértelmezett élettartama
pin_enabled body boolean opcionális
Opcionális PIN védelem az új postafiókhoz, ha a csomagja engedélyezi. Nem változtatja meg a meglévő postafiók PIN-kódját.
Alapértelmezett: false
pin body string opcionális
Szükséges, ha a pin_enabled igaz: egy 6‑8 számjegyből álló PIN, karakterláncként küldve a vezető nullák megőrzése érdekében.
pin_confirmation body string opcionális
Szükséges, ha a pin_enabled igaz. Pontosan meg kell egyeznie a pin-nel.
Idempotency-Key header string opcionális
PIN-védelemmel ellátott létrehozáshoz vagy törléshez szükséges: egy stabil, 16‑tól 128‑ig karakteres kulcs. Ismételd meg ugyanazt a kérést ugyanazzal a kulccsal a duplikált munka elkerülése érdekében.
A Gmail Alias API engedélyének engedélyezve kell lennie az előfizetési csomagban, vagy egy API Kredit csomaggal kell feloldani. Opcionális paraméterek: mode (auto, dot, plus, plus_dot), username (egyéni alias felhasználónév), domain (pl. gmail.com, googlemail.com), lifetime (engedélyezett értékek: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Hagyja ki az élettartamot, vagy hagyja üresen, hogy a jelenlegi havi/éves csomaghoz beállított Alapértelmezett E-mail Élettartamot használja. Küldjön egy engedélyezett élettartamot, például 1h, hogy felülírja az alapértelmezettet. A korlátlan csak akkor használható, ha a csomag alapértelmezéseként van beállítva, vagy kifejezetten kérik és engedélyezik. A body paraméterek, a mailbox_lifetime és az email_lifetime is elfogadottak; az első nem üres érték nyer ebben a sorrendben: lifetime, mailbox_lifetime, email_lifetime. Az érvénytelen vagy tiltott értékek HTTP 422-t adnak vissza ahelyett, hogy csendben egy alapértelmezettet választanának.
Gmail alias postafiók létrehozása
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2305,
        "pin_protected": false,
        "email": "example+alias123@gmail.com",
        "domain": "gmail.com",
        "provider": "gmail_alias",
        "expire_at": "2026-11-19T03:18:20+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:20+00:00",
        "email_token": "encrypted-email-token"
    }
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
data.id integer
Postafiók azonosító. A generált azonosítók, címek és tokenek minden postafióknál eltérnek.
data.pin_protected boolean
Megadja, hogy ez a postafiók PIN védelemmel rendelkezik-e. PIN vagy PIN hash nem kerül visszaadásra.
data.email string
Teljes postafiócím generálva.
data.domain string
A létrehozott postafiók domainje.
data.provider string
Postafiók szolgáltató: standard, gmail_alias vagy outlook_alias.
data.expire_at string|null
Érvényes lejárat ISO-8601 időbélyegként, vagy null egy korlátlan postafiók esetén.
data.expires_in_seconds number|null
Nem negatív másodpercek maradnak a számításkor; tört másodpercek is lehetségesek. A null korlátlan, nem nulla.
data.mailbox_state string
A jelenlegi postafiók állapota: aktív, szüneteltetett, lejárt vagy inaktív.
data.receiving_enabled boolean
Az, hogy ez a postafiók jelenleg elfogadja-e a bejövő üzeneteket.
data.message_count integer
Ismert összes üzenetszám; tükrözheti az utolsó postafiók szinkronizálást.
data.unread_message_count integer
Ismert olvasatlan üzenetek száma; tükrözheti az utolsó postafiók szinkronizálását.
data.last_message_received_at string|null
Az utolsó ismert fogadott üzenet időpontja ISO-8601 formátumban, vagy null, ha nem érhető el.
data.message_count_synced_at string|null
Az utolsó üzenetszám-szinkronizálás időpontja ISO-8601 formátumban, vagy null, ha a szinkronizáció előtt.
data.created_at string|null
A postafiók létrehozásának időpontja ISO-8601 formátumban.
data.email_token string
Átlátszatlan titkosított postafiók hivatkozás. Nem helyettesíti a Bearer hitelesítést, a tulajdonjog ellenőrzéseket vagy a PIN engedélyezést.
data.pin_grant object
Feltételes: az aktív PIN-védelemmel ellátott postafiók létrehozása visszaadja ezt az olvasási engedélyt; a szokásos, védtelen létrehozás kihagyja azt.
data.pin_grant.mailbox_id integer
Postafiók-azonosító, amelyhez a feltételes olvasási engedély kötve van.
data.pin_grant.unlock_token string
Átlátszatlan olvasási token az X-Mailbox-Unlock-hoz ugyanazzal a tulajdonosi hitelesítővel. Tartsd privátban és memóriában; egy olvasási engedély nem jogosít fel törlésre.
data.pin_grant.scope string
A feltételes létrehozási engedély hatókörének olvasása.
data.pin_grant.idle_timeout_seconds integer
A olvasási engedélyhez megengedett üresjárati idő, általában 3600 másodperc.
data.pin_grant.absolute_timeout_seconds integer
Az olvasási engedély maximális élettartama, általában 86400 másodperc.
data.pin_grant.expires_at string
A jelenlegi olvasási jogosultság lejárata ISO-8601 formátumban.
data.pin_grant.absolute_expires_at string
Abszolút olvasási engedély lejárata ISO-8601 formátumban. A biztonsági változások korábban visszavonhatják az engedélyt.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook alias domainek

Aktív Outlook/Hotmail alias domainok lekérése, amelyek a postafiók létrehozásához elérhetők.

Az Outlook Alias API engedélyének engedélyezése szükséges az előfizetési csomagban, vagy egy API Kredit csomaggal kell feloldani. Jelzi, hogy a konkrét domain kiválasztása fel van-e oldva a csomagjában.
Outlook alias domain-ek lekérése
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "data": {
        "domains": [
            {
                "domain": "outlook.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            },
            {
                "domain": "hotmail.com",
                "type": "Outlook/Hotmail",
                "selectable": true,
                "locked": false,
                "disabled_reason": null
            }
        ]
    }
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
data.domains array
Aktív Outlook/Hotmail domainek; egy üres tömb érvényes.
data.domains[].domain string
Elérhető domain név.
data.domains[].type string
Olvasható szolgáltató címke.
data.domains[].selectable boolean
Az, hogy a fiókja kifejezetten választhatja-e ezt a domaint.
data.domains[].locked boolean
Az, hogy a kifejezett domainválasztás zárolva van-e a fiókjában.
data.domains[].disabled_reason string|null
Az ok, hogy a tartomány kiválasztása zárolt, vagy null, ha választható.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Outlook alias létrehozása

Hozzon létre egy új Outlook / Hotmail alias ideiglenes postafiókot, amely a hitelesített felhasználó tulajdonában van.

Paraméterek 7
Paraméter Hely Típus Állapot Leírás
domain body string opcionális
Használjon véletlenszerűt vagy egy domaint a GET /outlook-alias/domains végpontból; az outlook_alias_domain is elfogadott. Kiválasztási engedély nélkül véletlenszerűt használnak.
Alapértelmezett: Véletlenszerű elérhető domain
username body string opcionális
Opcionális egyéni alias utótag: 2-tól 32-ig ASCII betű vagy szám, kisbetűre normalizálva; a funkció engedélyétől függ. Elfogadja a custom_username vagy alias_username értékeket is.
Alapértelmezett: Automatikusan generált
lifetime body string opcionális
engedélyezett értékek:
10m — 10 perc 1h — 1 Óra 2h — 2 Óra 1d — 1 nap 1w — 1 Hét 1m — 30 Nap 3m — 90 nap 6m — 180 nap 1y — 365 nap unlimited — Korlátlan
Alapértelmezett: A terv alapértelmezett élettartama
pin_enabled body boolean opcionális
Opcionális PIN védelem az új postafiókhoz, ha a csomagja engedélyezi. Nem változtatja meg a meglévő postafiók PIN-kódját.
Alapértelmezett: false
pin body string opcionális
Szükséges, ha a pin_enabled igaz: egy 6‑8 számjegyből álló PIN, karakterláncként küldve a vezető nullák megőrzése érdekében.
pin_confirmation body string opcionális
Szükséges, ha a pin_enabled igaz. Pontosan meg kell egyeznie a pin-nel.
Idempotency-Key header string opcionális
PIN-védelemmel ellátott létrehozáshoz vagy törléshez szükséges: egy stabil, 16‑tól 128‑ig karakteres kulcs. Ismételd meg ugyanazt a kérést ugyanazzal a kulccsal a duplikált munka elkerülése érdekében.
Az Outlook Alias API engedélyének engedélyezése szükséges az előfizetési csomagban, vagy egy API Kredit csomaggal kell feloldani. Opcionális paraméterek: domain (pl. outlook.com, hotmail.com), username (egyéni alias felhasználónév), lifetime (engedélyezett értékek: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Hagyja ki az élettartamot, vagy hagyja üresen, hogy a jelenlegi havi/éves csomaghoz beállított Alapértelmezett E-mail Élettartamot használja. Küldjön egy engedélyezett élettartamot, például 1h, hogy felülírja az alapértelmezettet. A korlátlan csak akkor használható, ha a csomag alapértelmezéseként van beállítva, vagy kifejezetten kérik és engedélyezik. A body paraméterek, a mailbox_lifetime és az email_lifetime is elfogadottak; az első nem üres érték nyer ebben a sorrendben: lifetime, mailbox_lifetime, email_lifetime. Az érvénytelen vagy tiltott értékek HTTP 422-t adnak vissza ahelyett, hogy csendben egy alapértelmezettet választanának.
Outlook alias postafiók létrehozása
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2306,
        "pin_protected": false,
        "email": "example+alias45@outlook.com",
        "domain": "outlook.com",
        "provider": "outlook_alias",
        "expire_at": "2026-11-19T03:18:20+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:20+00:00",
        "email_token": "encrypted-email-token"
    }
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
data.id integer
Postafiók azonosító. A generált azonosítók, címek és tokenek minden postafióknál eltérnek.
data.pin_protected boolean
Megadja, hogy ez a postafiók PIN védelemmel rendelkezik-e. PIN vagy PIN hash nem kerül visszaadásra.
data.email string
Teljes postafiócím generálva.
data.domain string
A létrehozott postafiók domainje.
data.provider string
Postafiók szolgáltató: standard, gmail_alias vagy outlook_alias.
data.expire_at string|null
Érvényes lejárat ISO-8601 időbélyegként, vagy null egy korlátlan postafiók esetén.
data.expires_in_seconds number|null
Nem negatív másodpercek maradnak a számításkor; tört másodpercek is lehetségesek. A null korlátlan, nem nulla.
data.mailbox_state string
A jelenlegi postafiók állapota: aktív, szüneteltetett, lejárt vagy inaktív.
data.receiving_enabled boolean
Az, hogy ez a postafiók jelenleg elfogadja-e a bejövő üzeneteket.
data.message_count integer
Ismert összes üzenetszám; tükrözheti az utolsó postafiók szinkronizálást.
data.unread_message_count integer
Ismert olvasatlan üzenetek száma; tükrözheti az utolsó postafiók szinkronizálását.
data.last_message_received_at string|null
Az utolsó ismert fogadott üzenet időpontja ISO-8601 formátumban, vagy null, ha nem érhető el.
data.message_count_synced_at string|null
Az utolsó üzenetszám-szinkronizálás időpontja ISO-8601 formátumban, vagy null, ha a szinkronizáció előtt.
data.created_at string|null
A postafiók létrehozásának időpontja ISO-8601 formátumban.
data.email_token string
Átlátszatlan titkosított postafiók hivatkozás. Nem helyettesíti a Bearer hitelesítést, a tulajdonjog ellenőrzéseket vagy a PIN engedélyezést.
data.pin_grant object
Feltételes: az aktív PIN-védelemmel ellátott postafiók létrehozása visszaadja ezt az olvasási engedélyt; a szokásos, védtelen létrehozás kihagyja azt.
data.pin_grant.mailbox_id integer
Postafiók-azonosító, amelyhez a feltételes olvasási engedély kötve van.
data.pin_grant.unlock_token string
Átlátszatlan olvasási token az X-Mailbox-Unlock-hoz ugyanazzal a tulajdonosi hitelesítővel. Tartsd privátban és memóriában; egy olvasási engedély nem jogosít fel törlésre.
data.pin_grant.scope string
A feltételes létrehozási engedély hatókörének olvasása.
data.pin_grant.idle_timeout_seconds integer
A olvasási engedélyhez megengedett üresjárati idő, általában 3600 másodperc.
data.pin_grant.absolute_timeout_seconds integer
Az olvasási engedély maximális élettartama, általában 86400 másodperc.
data.pin_grant.expires_at string
A jelenlegi olvasási jogosultság lejárata ISO-8601 formátumban.
data.pin_grant.absolute_expires_at string
Abszolút olvasási engedély lejárata ISO-8601 formátumban. A biztonsági változások korábban visszavonhatják az engedélyt.

Üzenetek és mellékletek

Hozza be a bejövő postafiókokat, olvassa el a teljes HTML/szöveges üzeneteket, és streamelje a mellékleteket.

GET https://v1.tempmailg.com/api/messages?email={email}
#

Postafiók üzeneteinek listázása

Lekérdezi a rendelkezésre álló üzenetösszefoglalókat és a postafiók metaadatait. A szabványos bejövő üzenet átvizsgálások legfeljebb 25 üzenetből álló legújabb csomagot adnak vissza; ez nem egy lapozható teljes előzmény végpont. Használja a GET /messages/{messageId} parancsot a teljes üzenettörzsek és mellékletek lekéréséhez.

Paraméterek 2
Paraméter Hely Típus Állapot Leírás
email query string kötelező
A tulajdonolt postafiók teljes e-mail címe, ahonnan az üzeneteket olvasni kell. URL-kódolja a lekérdezési értéket; a plusz jelet kódolja %2B‑ként.
X-Mailbox-Unlock header string opcionális
Fejléc, csak védett postafiókok: használjon read unlock_token-t. Először POST-oljon pin és scope=read a PIN feloldási URL-re. Tartsa meg a szokásos Bearer hitelesítést. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Az e-mailnek a fiókodhoz kell tartoznia. A standard és Gmail összefoglalók OTP és verification-link mezőket tartalmaznak; az Outlook továbbá tartalmazza a from_name, snippet, received_at és has_attachments mezőket. A szolgáltató szinkronizációja és gyorsítótára késleltetheti az új üzeneteket és a számlálókat.
Postaláda üzenetek olvasása
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "mailbox": "demo123@example.com",
    "email_token": "encrypted-email-token",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "receivedAt": "2026-11-19 02:18:20",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:18:20+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:18:20+00:00",
    "message_count_synced_at": "2026-11-19T02:18:20+00:00"
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
mailbox string
A postafiók címe, amelynek üzenetei lekérve lettek.
email_token string
Átlátszatlan titkosított postafiók hivatkozás; a normál hitelesítés továbbra is szükséges.
mailbox_provider string
Postafiók szolgáltató: standard, gmail_alias vagy outlook_alias.
messages array
Üzenet összefoglalók. Egy üres beérkező mappa egy üres tömböt ad vissza; egyetlen üzenetet lekérhet a törzséért és a mellékletekért.
expire_at string|null
Érvényes lejárat ISO-8601 időbélyegként, vagy null egy korlátlan postafiók esetén.
expires_in_seconds number|null
Nem negatív másodpercek maradnak a számításkor; tört másodpercek is lehetségesek. A null korlátlan, nem nulla.
mailbox_state string
A jelenlegi postafiók állapota: aktív, szüneteltetett, lejárt vagy inaktív.
receiving_enabled boolean
Az, hogy ez a postafiók jelenleg elfogadja-e a bejövő üzeneteket.
message_count integer
Ismert összes üzenetszám; tükrözheti az utolsó postafiók szinkronizálást.
unread_message_count integer
Ismert olvasatlan üzenetek száma; tükrözheti az utolsó postafiók szinkronizálását.
last_message_received_at string|null
Az utolsó ismert fogadott üzenet időpontja ISO-8601 formátumban, vagy null, ha nem érhető el.
message_count_synced_at string|null
Az utolsó üzenetszám-szinkronizálás időpontja ISO-8601 formátumban, vagy null, ha a szinkronizáció előtt.
mailbox_limit.limit integer
Aktív postafiók korlát ennél a szolgáltatónál; a -1 korlátlanságot jelent.
mailbox_limit.limit_label string
A postafiók korlátjának megjelenítési címkéje.
mailbox_limit.active_count integer
Az ebben a szolgáltatónál aktív postafiókok száma.
mailbox_limit.paused_count integer
A szolgáltatóhoz tartozó szüneteltetett postafiókok száma.
mailbox_limit.paused_mailboxes array<string>
Címek szüneteltetve a postafiók korlátja miatt.
mailbox_limit.remaining integer
Hátralévő aktív postafiók helyek; -1 jelent korlátlan. Ez nem API kérés kvóta.
mailbox_limit.remaining_label string
Megjelenítendő címke a megmaradt postafiókhelyekhez.
mailbox_limit.reached boolean
Az aktív postafiók korlátja elérve van-e.
mailbox_limit.blocked boolean
Az aktív postafiók korlátja nulla-e.
mailbox_limit.provider string|null
Szolgáltató, amelyre a postafiók korlátja vonatkozik.
messages[].id string
Átlátszatlan üzenetazonosító, amelyet az egyetlen üzenet, törlés és melléklet végpontok használnak.
messages[].is_seen boolean
Az üzenet olvasottként van megjelölve.
messages[].subject string
Üzenet tárgya.
messages[].from string
A feladó megjelenített neve vagy címe.
messages[].from_email string
Feladó e-mail címe.
messages[].receivedAt string
A fogadott idő az alkalmazás időzónájában, formázva YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Észlelt egyszeri kód, ha elérhető és engedélyezett; egyébként null.
messages[].otp_locked boolean
Az, hogy egy észlelt egyszeri kód rejtve van-e a funkció jogosultságai által.
messages[].verification_link string|null
Észlelt ellenőrző URL, ha elérhető és engedélyezett; egyébként null.
messages[].verification_link_locked boolean
Az, hogy egy észlelt ellenőrzési hivatkozás rejtve van-e a funkcióengedélyek által.
messages[].from_name string|null
Outlook összefoglaló mező: az eredeti feladó neve. Hiányzik a Standard és a Gmail összefoglalókból.
messages[].snippet string|null
Outlook összegző mező: rövid üzenet előnézet.
messages[].received_at string|null
Outlook összegző mező: ISO-8601 fogadott idő, ha ismert.
messages[].has_attachments boolean
Outlook összegző mező: létezik-e a melléklet metaadata. A letöltés elérhetőségét külön ellenőrzik.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Egyetlen üzenet lekérése

Hozzon vissza egy tulajdonolt üzenetet az átlátszatlan üzenetazonosítója alapján. Visszaadja a törzsformátumokat és a melléklet metaadatait. A törzsfájlok a üzenetformátumtól függenek; az Outlook a lenti szolgáltató‑specifikus mezőket adja hozzá.

Paraméterek 2
Paraméter Hely Típus Állapot Leírás
messageId path string kötelező
Az üzenetlistában visszaadott egyedi üzenetazonosító.
X-Mailbox-Unlock header string opcionális
Fejléc, csak védett postafiókok: használjon read unlock_token-t. Először POST-oljon pin és scope=read a PIN feloldási URL-re. Tartsa meg a szokásos Bearer hitelesítést. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Egy üzenet elolvasása
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "demo123@example.com",
        "mailbox_provider": "standard",
        "receivedAt": "2026-11-19 02:18:20",
        "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
        "html": true,
        "html_content": "<p>Hello from the inbox.</p>",
        "text_content": "<pre>Hello from the inbox.</pre>",
        "content": "<p>Hello from the inbox.</p>",
        "attachments": [
            {
                "name": "file.txt",
                "extension": "txt",
                "size": 91,
                "url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
            }
        ]
    }
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
data.id string
Átlátszatlan üzenetazonosító.
data.is_seen boolean
Üzenet olvasási állapota. Az olvasás megjelölheti láttként; a gyorsítótárazott adatok korábbi állapotot tükrözhetnek.
data.subject string
Üzenet tárgya.
data.from string
A feladó megjelenített neve vagy címe.
data.from_email string
Feladó e-mail címe.
data.to string
Címzett postafiók címe.
data.mailbox_provider string
Postafiók szolgáltató: standard, gmail_alias vagy outlook_alias.
data.receivedAt string
A fogadott idő az alkalmazás időzónájában, formázva YYYY-MM-DD HH:mm:ss.
data.html boolean
Megmutatja, hogy az üzenetnek van-e HTML törzse.
data.html_content string
HTML törzs, ha jelen van. A HTML nélküli szabványos üzenetek kihagyhatják ezt a mezőt. A üzenettartalmat tekintse megbízhatatlannak.
data.text_content string
Szövegtörzs, ha jelen van; a szabványos üzenetek tartalmazhatnak escaped szöveget egy pre elemben, vagy kihagyhatják ezt a mezőt.
data.content string
A megjelenítéshez preferált törzs, általában HTML, ha elérhető.
data.attachments array
Melléklet metaadatai, vagy egy üres tömb. A letöltésekhez normál hitelesítés és a megfelelő PIN-engedély szükséges.
data.attachments[].name string
Fájlnév, amelyet URL-kódolni kell egyetlen útvonal szegmensként a letöltés során.
data.attachments[].size integer
Melléklet mérete bájtokban.
data.attachments[].url string
Az azonosított felhasználó API letöltési URL-je hozzáadva a mellékletekhez fájlnévvel. Egy URL nem garantálja, hogy a helyi fájl elérhető.
data.attachments[].extension string
Standard/Gmail metaadat mező: fájlkiterjesztés, ha meg van adva.
data.attachments[].id string
Outlook metaadatmező: szolgáltató melléklet-azonosító.
data.attachments[].content_type string
Outlook metaadatmező: MIME tartalomtípus.
data.from_name string|null
Outlook részletmező: az eredeti feladó neve.
data.to_email string|null
Outlook részletmező: az eredeti címzett címe.
data.received_at string|null
Outlook részletmező: ISO-8601 fogadott idő.
data.has_html boolean
Outlook részletmező: létezik-e HTML-törzs.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Üzenet törlése

Egyetlen saját üzenet törlése.

Paraméterek 3
Paraméter Hely Típus Állapot Leírás
messageId path string kötelező
Egyedi üzenetazonosító karakterlánc a végleges törléshez.
X-Mailbox-Unlock header string opcionális
Fejléc, csak védett postafiókok esetén: használja az egyszeri törléshez szánt unlock_token-t. Először POST pin, scope=delete és a 423 válaszban visszaadott action/target_id a PIN feloldási URL-hez. Egy olvasási token nem tud törölni. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opcionális
PIN-védelemmel ellátott létrehozáshoz vagy törléshez szükséges: egy stabil, 16‑tól 128‑ig karakteres kulcs. Ismételd meg ugyanazt a kérést ugyanazzal a kulccsal a duplikált munka elkerülése érdekében.
Töröljön egy üzenetet
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Válaszmezők
Mező Típus Leírás
status boolean
Az operáció sikeres volt-e.
message string
A törlés eredménye. Hiányzó erőforrás esetén HTTP 404-et ad vissza.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Melléklet letöltése

Töltse le egy csatolt fájlt egy saját üzenetből.

Paraméterek 3
Paraméter Hely Típus Állapot Leírás
messageId path string kötelező
Az üzenet azonosítója, amely a fájlt tartalmazza.
filename path string kötelező
A letöltendő melléklet fájlneve és kiterjesztése.
X-Mailbox-Unlock header string opcionális
Fejléc, csak védett postafiókok: használjon read unlock_token-t. Először POST-oljon pin és scope=read a PIN feloldási URL-re. Tartsa meg a szokásos Bearer hitelesítést. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
A siker esetén a fájl bájtjai kerülnek visszaadásra, nem JSON. A túl nagy fájlok HTTP 403-at adnak vissza; a hiányzó vagy nem elérhető helyi fájlok HTTP 404-et adnak vissza. A fájlnevet URL-kódolni kell egyetlen útvonal szegmensként. A melléklet metaadatai önmagukban nem garantálják a letöltés elérhetőségét.
Töltse le egy csatolást
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY' \
  --output file.txt
Letöltési viselkedés Ez a végpont a kért fájlt közvetlenül adja vissza, ahelyett, hogy egy JSON testet adna vissza.
Válaszmezők
Mező Típus Leírás
Content-Disposition header
A sikeres válasz letölti a kért fájlnevet.
body binary
Siker esetén fájl bájtok, nem JSON. Hibák JSON-t adnak vissza nem 2xx státusszal.

Sebességkorlátok & kvóták

Figyelje a valós idejű kéréskereteket, a sebességkorlátokat és a fiók kvótákat anélkül, hogy krediteket fogyasztana.

GET https://v1.tempmailg.com/api/rate-limit
#

Sebességkorlát és kvóta

Ellenőrizze a jelenlegi sebességkorlátot és kvótaállapotot anélkül, hogy API használatot fogyasztana. Ez a végpont kvóta-mentes, és nem von le havi API krediteket (visszaélés elleni védelem korlátja: 60 kérés/perc).

Az X-RateLimit-* a jelzett kérési költségkeretet írja le; az X-Quota-* a havi és megvásárolt kapacitást írja le, ha elérhető. Az X-Mailbox-RateLimit-* a különálló postafiók létrehozási/frissítési költségkeretet jelenti. A csak postafiókra vonatkozó elutasítás a postafiók hatókörét és saját újrapróbálkozási időablakát használja. A perckorlátú elutasítások kihagyhatják a kvóta információt. A Retry-After csak időzített újrapróbálkozás esetén szerepel; a letiltott hozzáféréshez fiókváltoztatás szükséges. Ebben a sikeres állapotválaszban a data.limit, data.remaining és data.reset az fiók perc költségvetését írja le, nem a felhasználható krediteket. A data.quota objektum a havi keretet, a kredit egyenlegeket és a felhasználást írja le. A meglévő data.monthly_limit, data.monthly_remaining és data.purchased_credits mezők az adott kvóta mezők aliasai maradnak. A sikeres állapotellenőrzés nem jogosít fel egy másik API műveletet. A műveletekhez továbbra is engedélyezett hozzáférés, elérhető kvóta és az összes alkalmazandó korláton való áthaladás szükséges. A kvóta pillanatkép nem ígéri a már folyamatban lévő kérés által lefoglalt kapacitást.
Ellenőrizze a sebességkorlát állapotát
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illusztratív válasz szintetikus adatok használatával. Az azonosítók, címek, tokenek, időbélyegek, csomagkorlátok és számok változóak. A mintavételi élettartamok nem írják felül az Ön csomag alapértelmezését. A válaszmezők leírása jelzi a nullázható és szolgáltató-specifikus mezőket.

Példa válasz
200 OK • JSON
{
    "status": "success",
    "data": {
        "limit": 60,
        "remaining": 45,
        "reset": 32,
        "plan": "premium",
        "monthly_limit": 50000,
        "monthly_remaining": 48210,
        "purchased_credits": 5000,
        "quota": {
            "enabled": true,
            "user_api_status": true,
            "plan_name": "Premium Plan",
            "period": "2026-10",
            "base_limit": 50000,
            "extra_requests": 0,
            "monthly_limit": 50000,
            "monthly_remaining": 48210,
            "used": 1790,
            "purchased_credits": 5000,
            "bonus_credits": 1000,
            "direct_purchased_credits": 4000,
            "remaining": 53210,
            "unlimited": false,
            "usage_percent": 3,
            "reset_at": "2026-11-01T00:00:00+00:00"
        }
    }
}
Válaszmezők
Mező Típus Leírás
data.limit integer|string
Fiók kérés-per-perc korlát. Az unlimited karakterlánc korlátlan perc költségvetést jelöl; ez független a havi kvótától.
data.remaining integer|string
A fennmaradó fiók perc-költségvetési slotok, vagy a "unlimited" szöveg. A pozitív érték nem jelenti, hogy API kreditek maradtak.
data.reset integer
Másodpercek a fiók percablakához, nem a havi kvóta visszaállításához. Letiltott vagy korlátlan perckeretek megtarthatnak egy névleges 60 másodperces értéket; ez nem ígéri a hozzáférést a várakozás után.
data.plan string
Aktuális csomag címke. Az olvasható csomagnév külön van megadva a data.quota.plan_name mezőben.
data.quota.enabled boolean
Az, hogy a globális és a terv/kredit API hozzáférés engedélyezve van-e. Ez nem jelzi a fennmaradó kapacitást, és nem helyettesíti a felhasználói API kapcsolót.
data.quota.user_api_status boolean
Az, hogy a felhasználó engedélyezte-e a Felhasználói API kapcsolót. A műveletekhez ez a kapcsoló, valamint az engedélyezett hozzáférés és a rendelkezésre álló kapacitás szükséges.
data.quota.plan_name string
Olvasható név a jelenlegi csomagról.
data.quota.period string
Naptári hónap használati időszak YYYY-MM formátumban, az alkalmazás időzónáját használva; nem feltétlenül a feliratkozási számlázási időszak.
data.quota.base_limit integer
Alap havi csomagkeret. A -1 érték korlátlanságot jelent.
data.quota.extra_requests integer
További havi keret biztosítva az aktuális használati időszakra; külön a megvásárolt kreditektől.
data.quota.monthly_limit integer
Alapkeret plusz a jelen időszak extra kérései. A -1 érték korlátlanságot jelent. A megvásárolt krediteket nem tartalmazza.
data.quota.monthly_remaining integer|null
A fennmaradó véges havi keret, vagy null, ha a havi kvóta korlátlan. A null nem értelmezhető nullaként.
data.quota.used integer
Sikeres, számított API műveletek az aktuális használati időszakban, beleértve a kreditekkel végzett műveleteket. Az állapotellenőrzések nem növelik ezt az értéket.
data.quota.purchased_credits integer
Aktuális kredit egyenleg, beleértve az aktív csomag bónusz kreditjeit. A bónusz krediteket nem szabad másodszor ehhez az egyenleghez hozzáadni.
data.quota.bonus_credits integer
Az aktív tervbónusz része a kredit egyenlegnek; a purchased_credits felbontása, nem további kapacitás.
data.quota.direct_purchased_credits integer
A kredit egyenleg az aktív csomag-bónusz rész nélkül. Ez az érték plusz a bonus_credits egyenlő a purchased_credits-szel.
data.quota.remaining integer|null
A havi megmaradt keret plusz a jelenlegi kredit egyenleg, a bónuszok dupla számolása nélkül. A null érték korlátlan havi kvótát jelent. Az egyéni funkcióengedélyek és egyéb kéréskorlátok továbbra is érvényesek.
data.quota.unlimited boolean
A havi kvóta korlátlansága. Ez nem teszi korlátlanná a fiók perc költségvetését vagy más funkciókorlátokat.
data.quota.usage_percent integer
Műszerfal-kompatibilis kerekített százalék 0 és 100 között: felhasznált osztva a felhasznált plusz a maradék, szorozva 100-zal. Tartalmazza a rendelkezésre álló hitelkapacitást, így a feltöltés csökkentheti a százalékot. Korlátlan kvóta vagy nulla méretű pool esetén 0; nem a percenkénti sebességkorlátozás százaléka vagy hozzáférési döntés.
data.quota.reset_at string
ISO-8601 időbélyeg időzóna eltolással a következő naptári hónap kvóta visszaállításához. Ez nem a előfizetés lejárati dátuma, és a havi visszaállítás nem tölti fel a megvásárolt krediteket.
status string
A szó szerinti siker ennél a státusz végpontnál. Más sikeres postafiók végpontok a logikai true értéket használják.
data.monthly_limit integer
A megfelelő data.quota mező kompatibilitási aliasa; ne adja hozzá újra az egyenlegek számításakor.
data.monthly_remaining integer|null
A megfelelő data.quota mező kompatibilitási aliasa; ne adja hozzá újra az egyenlegek számításakor.
data.purchased_credits integer
A megfelelő data.quota mező kompatibilitási aliasa; ne adja hozzá újra az egyenlegek számításakor.

Postafiók PIN védelem

Adja meg a PIN-kódot a folytatáshoz. A postafiókja feloldott marad, amíg ez a weboldal munkamenetben aktuális.

Elfogadja a sütiket?

Sütiket használunk a böngészési élmény fokozása érdekében. A webhely használatával hozzájárul az sütikre vonatkozó politikánkhoz.

Több