Gyors beállítási ellenőrzőlista
- Nyissa meg a dashboard API Kezelés oldalt, és hozza létre a személyes API-kulcsát.
- Másolja le a pontos Felhasználói API Alap URL-t, pl. https://v1.tempmailg.com/api.
- Küldje el minden kérést annak az API-hosztnek a Authorization: Bearer YOUR_USER_API_KEY és Accept: application/json.
- Kövesse nyomon havi kérési kvótáját ugyanarról a műszerfal oldalról, valamint a kvóta fejlécekből, ha elérhetők a felhasználói API válaszokban. Csak a sikeres 2xx kérések számítanak a kvótába.
API kulcs hozzáférés
Jelentkezzen be személyes API kulcsának létrehozásához és az élő kvóta részleteinek megtekintéséhez.
Hitelesítési folyamat
- Hozza létre a személyes API-kulcsát az irányítópult API-kezelő oldaláról.
- Küldje el a kulcsot minden kérésben Bearer tokenként.
- Használja a dedikált Felhasználói API alap URL-t, amely az API-kezelő oldalon megjelenik.
- Regenerálja a kulcsot bármikor, ha érvényteleníteni szeretné a régit, és azonnal elkezdené használni egy új kulcsot.
Szükséges fejlécek
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Sebességkorlát & Kvóta Fejlécek
Rate-limit fejlécek leírják a jelzett kérés költségvetését. Kvóta fejlécek akkor kerülnek bele, ha a kvóta információ elérhető; a perc-korlátozási elutasítások nem számítják ki a teljes havi kvótádat.
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1729520000
X-Quota-Limit: 50000
X-Quota-Remaining: 48210
X-Quota-Used: 1790
X-Quota-Reset: 2026-11-01T00:00:00+00:00
X-RateLimit-Scope: account
Retry-After: 42 (when a timed retry is available)
X-RateLimit-Limit— Az Ön csomagjában percenként megengedett maximális kérésszám (RPM).X-RateLimit-Remaining— RPM kérések maradtak az aktuális percablakban.X-RateLimit-Reset— Unix időbélyeg, amikor az aktuális perc sebességkorlát ablak visszaáll.X-Quota-Limit— Az Ön fiókjának teljes havi és megvásárolt kreditkapacitása.X-Quota-Remaining— A jelenlegi hónapban hátralévő elérhető API kérések.X-Quota-Used— A jelenlegi számlázási időszakban felhasznált összes API-kérés.X-Quota-Reset— ISO-8601 időbélyeg, amikor a havi kvóta visszaáll.X-RateLimit-Scope— A költségvetés a fejlécekben leírt: account, ip, status_endpoint vagy mailbox.X-Mailbox-RateLimit-*— Külön postafiók létrehozási/frissítési költségvetés. A sikeres postafiók válaszok megtartják a fiók RPM-et az X-RateLimit-* fejlécekben; 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.Retry-After— Másodpercek, amíg egy időzített újrapróbálkozás megfelelő. Egy letiltott csomag vagy kimerült kvóta helyett fiókváltást igényelhet, ezért ez a fejléc nem mindig jelenik meg.503 protection_unavailable— Az API védelmi tárolás vagy koordináció ideiglenesen nem érhető el. Próbálja újra később; ez nem fizetési hiba vagy hitellevonás.
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.
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é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ő
|
const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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
}
]
}
}
| 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. |
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é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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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:08:06+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:08:06+00:00",
"email_token": "encrypted-email-token"
}
}
| 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. |
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é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>
|
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.const response = await fetch('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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:18:06+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:08:06+00:00",
"email_token": "encrypted-email-token"
}
}
| 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. |
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é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.
|
const response = await fetch('https://v1.tempmailg.com/api/emails/demo123@example.com', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/emails/demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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."
}
| 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.
Gmail alias létrehozása
Hozzon létre egy új Gmail alias ideiglenes postafiókot, amely a hitelesített felhasználóhoz tartozik.
| 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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/gmail-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/gmail-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/gmail-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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:08:06+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:08:06+00:00",
"email_token": "encrypted-email-token"
}
}
| 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. |
Outlook alias domainek
Aktív Outlook/Hotmail alias domainok lekérése, amelyek a postafiók létrehozásához elérhetők.
const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/domains', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/outlook-alias/domains', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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
}
]
}
}
| 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ó. |
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é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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/outlook-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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:08:06+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:08:06+00:00",
"email_token": "encrypted-email-token"
}
}
| 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.
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é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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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:08:06",
"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:08:06+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:08:06+00:00",
"message_count_synced_at": "2026-11-19T02:08:06+00:00"
}
| 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. |
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é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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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:08:06",
"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"
}
]
}
}
| 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. |
Üzenet törlése
Egyetlen saját üzenet törlése.
| 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.
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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."
}
| 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. |
Melléklet letöltése
Töltse le egy csatolt fájlt egy saját üzenetből.
| 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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()
with open('file.txt', 'wb') as handle:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
handle.write(chunk)
<?php
$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_FILE => $fileHandle,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
if (curl_exec($ch) === false) {
fclose($fileHandle);
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
fclose($fileHandle);
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
| 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.
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).
const response = await fetch('https://v1.tempmailg.com/api/rate-limit', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/rate-limit', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/rate-limit');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
}
}
| 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. |
Postai Webhook-ek (Valós időben történő push)
A REST API (GET /messages) többszörös lekérdezése helyett beállíthatja a Webhook-eket, hogy új levelek valós időben eljuttassák a szerverére vagy automatizált folyamatába.
Támogatott Webhook Események
Egy webhook egy vagy több esemény típussal lehet előírva. Az endpointed egy esemény értesítést kap, amikor az egyik ezekből bekövetkezik.
Valós időben küldve, amikor egy új üzenet eléri a kiválasztott postafiókot.
Kiküldve, amikor az ideiglenes postafiók lejár, és a webhook feldolgozás szünetel.
Kiküldve, amikor egy lejárt postafiók újra aktív lesz a terv szabályai szerint.
Kiküldve közvetlenül a webhook és a postafiókja törlése előtt.
Kérések fejlécei & HMAC aláírás ellenőrzése
Mindennek a webhook-küldésnek különleges biztonsági fejlécei vannak. Használja az X-TempMailg-Signature fejléct, hogy megerősítse, hogy az érkező kérések valóban TempMailg által küldtek és nem voltak megcserélve.
| Fejezet neve | Példa érték | Leírás |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Standard azonosító a webhook kézbesítő munkavállalóhoz. |
X-TempMailg-Event |
email.received | Az esemény típusa, amely ezt a kézbesítést kiváltotta. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Az ehhez a kézbesítési kísérlethez rendelt egyedi UUID. |
X-TempMailg-Timestamp |
1725192000 | Unix epoch időbélyeg, amely jelzi, mikor indult a kérés. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | HMAC-SHA256 aláírás, amely a {timestamp}.{raw_body} alapján, a titkos kulcsod felhasználásával kerül kiszámításra. |
X-TempMailg-Test |
false | Igaz, ha a műszerfalán lévő "Send Test Ping" funkcióval kerül elküldésre. |
A alábbi szövegről számított HMAC SHA256-al:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Minta Esemény Adatcsomag (email.received)
Az HTTP POST kérés testében `application/json` formátumban küldve.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:08:07+00:00",
"test": false,
"mailbox": {
"id": 1024,
"email": "developer@v1.tempmailg.com"
},
"data": {
"message_id": "7a8b9c0d1e2f",
"subject": "Your Verification Code: 948201",
"from": "auth@service.com",
"to": "developer@v1.tempmailg.com",
"date": "2026-11-19T02:08:07+00:00",
"attachments_count": 0,
"text_preview": "Hello, your one-time verification code is 948201. It will expire in 10 minutes.",
"email_url": "https://tempmailg.com/mailbox/1024?message=7a8b9c0d1e2f",
"inbox_url": "https://tempmailg.com/mailbox/1024"
}
}
Fogadó megvalósítási példák
Válassza ki a nyelvet, hogy lássa, hogyan fogadhat webhookokat, és ellenőrizheti biztonságosan a HMAC aláírásokat.
const express = require('express');
const crypto = require('crypto');
const app = express();
const WEBHOOK_SECRET = 'your_webhook_signing_secret';
// Capture raw body buffer for HMAC-SHA256 signature verification
app.use(express.json({
verify: (req, res, buf) => {
req.rawBody = buf.toString('utf8');
}
}));
app.post('/webhook', (req, res) => {
const timestamp = req.headers['x-tempmailg-timestamp'];
const signatureHeader = req.headers['x-tempmailg-signature'] || '';
// Calculate HMAC-SHA256 signature
const expectedSignature = 'sha256=' + crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(`${timestamp}.${req.rawBody}`)
.digest('hex');
// Verify signature
if (signatureHeader !== expectedSignature) {
return res.status(401).json({ error: 'Invalid webhook signature' });
}
const { event, mailbox, data } = req.body;
console.log(`[Event: ${event}] Mailbox: ${mailbox.email}`);
if (event === 'email.received') {
console.log(`From: ${data.from}`);
console.log(`Subject: ${data.subject}`);
console.log(`Preview: ${data.text_preview}`);
}
// Acknowledge receipt with HTTP 200
res.status(200).json({ received: true });
});
app.listen(3000, () => console.log('Webhook receiver running on port 3000'));
from flask import Flask, request, jsonify
import hmac
import hashlib
app = Flask(__name__)
WEBHOOK_SECRET = b"your_webhook_signing_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
timestamp = request.headers.get("X-TempMailg-Timestamp", "")
signature_header = request.headers.get("X-TempMailg-Signature", "")
# Calculate expected HMAC-SHA256 signature
raw_body = request.get_data()
signed_payload = f"{timestamp}.".encode("utf-8") + raw_body
expected_signature = "sha256=" + hmac.new(
WEBHOOK_SECRET, signed_payload, hashlib.sha256
).hexdigest()
# Verify signature securely
if not hmac.compare_digest(signature_header, expected_signature):
return jsonify({"error": "Invalid signature"}), 401
payload = request.get_json()
event = payload.get("event")
mailbox = payload.get("mailbox", {}).get("email")
data = payload.get("data", {})
print(f"[{event}] Mailbox: {mailbox}")
if event == "email.received":
print(f"From: {data.get('from')}")
print(f"Subject: {data.get('subject')}")
print(f"Preview: {data.get('text_preview')}")
# Return 200 OK to acknowledge receipt
return jsonify({"received": True}), 200
if __name__ == "__main__":
app.run(port=5000)
<?php
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_TEMPMAILG_TIMESTAMP'] ?? '';
$receivedSignature = $_SERVER['HTTP_X_TEMPMAILG_SIGNATURE'] ?? '';
// Calculate HMAC-SHA256 signature
$expectedSignature = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
// Verify signature
if (!hash_equals($expectedSignature, $receivedSignature)) {
http_response_code(401);
echo json_encode(['error' => 'Invalid signature']);
exit;
}
$payload = json_decode($rawBody, true);
$event = $payload['event'] ?? '';
$mailbox = $payload['mailbox']['email'] ?? '';
$data = $payload['data'] ?? [];
if ($event === 'email.received') {
$sender = $data['from'] ?? '';
$subject = $data['subject'] ?? '';
$preview = $data['text_preview'] ?? '';
// Process new incoming email...
}
// Acknowledge receipt
http_response_code(200);
echo json_encode(['received' => true]);
Támogatott platformok és automatizálási integrációk
A TempMailg webhookok azonnal működnek szabványos HTTPS végpontokkal és vezető kód nélküli/automatizálási platformokkal:
Gyakori hibák és hibakeresés
Ezek a leggyakoribb válasz kódok, amelyeket a felhasználói API integrálása során láthat.
Érvénytelen, hiányzó vagy visszavont Bearer token.
A tulajdonjog, funkcióengedélyek, domain hozzáférés vagy a melléklet mérete megakadályozta a műveletet. Ellenőrizze a válaszkódot és az üzenetet.
Az erőforrás nem található a megengedett hosztalon, vagy nem tartozik a felhasználóhoz.
Az operációs kulcsot újra felhasználták eltérő részletekkel, egy másik művelet függőben van, vagy a postafiók biztonsága megváltozott. Ellenőrizze a kódot a újrapróbálás előtt.
A postaládája lejárt vagy inaktív.
Érvénytelen paraméterek, tiltott élettartam, nem elérhető alias kapacitás, érvénytelen PIN beállítás vagy hiányzó/érvénytelen Idempotency-Key akadályozta a műveletet.
Egy védett postafióknak érvényes, hatókörrel rendelkező X-Mailbox-Unlock tokenre van szüksége. A törléshez használja a válaszból kapott action és target_id értékeket. A kizárás vagy helyreállítási követelményeket meg kell oldani a újrapróbálkozás előtt.
Kéréskorlát, letiltott terv, kimerült kvóta vagy hűtési idő akadályozta a műveletet. Ellenőrizze az okot és az elérhető költségvetés fejléceket. A Retry-After opcionális.
A szerver nem tudta befejezni a műveletet. Védett létrehozás vagy törlés esetén tartsa meg ugyanazt a kérést és az Idempotency-Key-t az újrapróbálkozáskor.
A védelem tárolását vagy koordinációját nem sikerült ellenőrizni. Próbálja újra a megadott késleltetés után. Ez a válasz nem hibás fizetés.
Gyors ellenőrző lista
- 401 Unauthorized - A Bearer token hiányzik, helytelen, visszavonva vagy rosszul másolt.
- 403 Forbidden - A jelenlegi terv nem rendelkezik felhasználói API-hozzáféréssel jelenleg.
- 404 Not Found - Nem található erőforrás vagy érvénytelen paraméter
- 410 Gone / Expired - Postafiók lejárt vagy már nem aktív.
- 429 Rate Limited - Ellenőrizze a válasz okát és a költségvetési fejléceket. A Retry-After csak az időkorlátokra vonatkozik; a kimerült kreditek vagy a letiltott hozzáférés fiókváltoztatást igényelhetnek.
Ajánlott következő lépés
Ha be van jelentkezve, először nyissa meg az API Kezelést, és ellenőrizze a kulcsát, a kvótáját, a csomagjához való hozzáférés állapotát, valamint a pontos Felhasználói API Alap URL-t, mielőtt hibakeresést végezne a külső alkalmazásában.