Kontrolli i shpejtë i konfigurimit
- Hapni faqen e menaxhimit të API-ve të tabloidit tuaj dhe krijo çelësin tuaj personal API.
- Kopjoni URL-në e saktë të bazës së API-ve të përdoruesit që tregohet atje, për shembull https://v1.tempmailg.com/api.
- Dërgoni çdo kërkesë në atë host API me Authorization: Bearer YOUR_USER_API_KEY dhe Accept: application/json.
- Ndjekni kuotën tuaj mujore të kërkesave nga e njëjta faqe e pultit dhe nga titujt e kuotës kur janë të disponueshme në përgjigjet e API-së së përdoruesit. Vetëm kërkesat e suksesshme 2xx numërohen drejt kuotës.
Qasje me çelës API
Kyçu për të krijuar çelësin API personal dhe për të parë detajet e kuotës së drejtpërdrejtë.
Fluxi i autentikimit
- Gjeneroni çelësin tuaj personal API nga faqja e Menaxhimit të API në shërbire.
- Dërgoni çelësin si një token Bearer në çdo kërkesë.
- Përdorni URL bazë të dedikuar të API të përdoruesit të shfaqur në faqen tuaj të Menaxhimit të API.
- Rigjeneroni çelësin në çdo kohë që doni të shpallni të vjetër dhe filloni përdorimin e një çelësi të ri menjëherë.
Header të kërkuar
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Kufiri i Shkallës & Titujt e Kuotës
Kryet e limitit të shpejtësisë përshkruajnë buxhetin e kërkesës së treguar. Kryet e kuotës përfshihen kur informacioni i kuotës është i disponueshëm; refuzimet e limitit në minutë nuk llogaritin kuotën tuaj të plotë mujore.
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— Kërkesat maksimale të lejuara për minutë (RPM) për planin tuaj.X-RateLimit-Remaining— Kërkesat RPM të mbetura në dritaren e minutës aktuale.X-RateLimit-Reset— Vulë kohore Unix kur rivendos dritarja e kufirit të shpejtësisë për minutën aktuale.X-Quota-Limit— Kapaciteti total mujor dhe i blerë i kreditit për llogarinë tuaj.X-Quota-Remaining— Kërkesat e API-së të mbetura në dispozicion në muajin aktual.X-Quota-Used— Totali i kërkesave API të konsumuar gjatë periudhës aktuale të faturimit.X-Quota-Reset— Vulë kohore ISO-8601 kur rivendos kuota juaj mujore.X-RateLimit-Scope— Buxheti i përshkruar nga titujt: account, ip, status_endpoint, ose mailbox.X-Mailbox-RateLimit-*— Buxhet i veçantë për krijimin/azhurnimin e kutisë postare. Përgjigjet e suksesshme të kutisë postare mbajnë RPM-in e llogarisë në X-RateLimit-*; një refuzim vetëm për kutinë postare përdor fushën e kutisë postare dhe dritaren e vet të riprovimit.Retry-After— Sekonda deri sa një riprovë e kohëzuar të jetë e përshtatshme. Një plan i çaktivizuar ose kuota e shteruar mund të kërkojë një ndryshim llogarie në vend të kësaj, kështu që kjo krye nuk është gjithmonë e pranishme.503 protection_unavailable— Ruajtja ose koordinimi i mbrojtjes API është përkohësisht i padisponueshëm. Riprovo më vonë; kjo nuk është një dështim pagese ose një debit krediti.
Menaxhim i kutisë postare
Merr domene të lejuara, krijo ose ndrysho kutitë postare, zgjidh jetëgjatësitë e lejuara, dhe fshi adresat e pronuara.
Listë e domain-eve të lejuara
Listë e domain-eve të disponueshme për krijimin e email-eve të përkohshme. Filtroni sipas llojit për të parë vetëm domain-et falas, premium, ose të personalizuara të mbështetura nga plani juaj i abonimit.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
type
|
query | string | opsionale |
Filtri i nivelit të domenit. Mospërfshirja përdor të gjitha kur qasja në domen premium është e aktivizuar, përndryshe falas. Vlerat e njohura: free, basic, pro, premium, custom, ultimate, all
Parazgjedhje:
Varur nga llogaria
|
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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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
}
]
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
data.requested_type |
string | U aplikua filtri i domenit. |
data.plan |
string | Etiketa e planit aktual. |
data.plan_name |
string | Emri i lexueshëm i planit aktual. |
data.allowed_types |
array<string> | Filtrat e domenit të disponueshëm për këtë llogari. Një filtër i njohur mund të ndalohet ende për planin tuaj. |
data.domains |
array | Domainet e përzgjedhshme pas filtrimit; një varg i zbrazët është i vlefshëm. |
data.domains[].domain |
string | Emër domeni i përzgjedhshëm. |
data.domains[].type |
string | Etiketa e nivelit të domenit të lexueshëm. |
data.domains[].custom |
boolean | Nëse ky është një domen i personalizuar. |
Krijo Kutinë Postare të Përkohshme
Krijoni një kuti postare të përkohshme në pronësi. Lini jashtë emrin e përdoruesit dhe domenin për gjenerim të rastësishëm, ose jepni një emër përdoruesi të personalizuar të lejuar dhe një domen të lejuar. Parametri provider mund të zgjedhë gjenerimin e alias-it Gmail ose Outlook.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
username
|
body | string | opsionale |
Emri i përdoruesit i personalizuar opsional: 2 deri në 64 shkronja ASCII, shifra, pika, nënvija ose vija mesatare. Kërkon leje të planit; custom_username pranohet gjithashtu.
Parazgjedhje:
Gjeneruar rastësisht
|
domain
|
body | string | opsionale |
Një nga domenet e lejuara të kthyer nga GET /domains. Mospërfshirja zgjedh një domen të lejuar rastësisht.
Parazgjedhje:
Domen i lejuar rastësisht
|
lifetime
|
body | string | opsionale |
vlerat e lejuara:
10m — 10 Minuta
1h — 1 Orë
2h — 2 Ora
1d — 1 Ditë
1w — 1 javë
1m — 30 Ditë
3m — 90 Ditë
6m — 180 Ditë
1y — 365 Ditë
unlimited — I Pakufishëm
Parazgjedhje:
Kohëzgjatja e paracaktuar e planit
|
provider
|
body | string | opsionale |
Furnizuesi i kutisë postare: standard, gmail_alias, ose outlook_alias.
Parazgjedhje:
standard
|
pin_enabled
|
body | boolean | opsionale |
Mbrojtje PIN opsionale për kutinë postare të re, kur lejohet nga plani juaj. Nuk ndryshon PIN-in e një kutie postare ekzistuese.
Parazgjedhje:
false
|
pin
|
body | string | opsionale |
Kërkohet kur pin_enabled është i vërtetë: një PIN prej 6 deri në 8 shifra, i dërguar si një varg për të ruajtur zeroet në fillim.
|
pin_confirmation
|
body | string | opsionale |
Kërkohet kur pin_enabled është true. Duhet të përputhet saktësisht me pin.
|
Idempotency-Key
|
header | string | opsionale |
E domosdoshme për krijimin ose fshirjen e mbrojtur me PIN: një çelës i qëndrueshëm me 16 deri në 128 karaktere. Rifilloni kërkesën identike me të njëjtin çelës për të shmangur punë të dyfishtë.
|
username (emër përdoruesi i personalizuar nëse lejohet nga plani), domain (domain i lejuar, p.sh. example.com), lifetime (vlerat e lejuara: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Injoro kohëzgjatjen, ose lëre bosh, për të përdorur Kohëzgjatjen e Parazgjedhur të Email-it të konfiguruar për planin tuaj aktual mujor/vjetor. Dërgo një kohëzgjatje të lejuar, si p.sh. 1h, për të anashkaluar atë parazgjedhje. Pa kufi përdoret vetëm kur është konfiguruar si parazgjedhja e planit ose kur kërkohet dhe lejohet në mënyrë të qartë. Parametrat e trupit mailbox_lifetime dhe email_lifetime gjithashtu pranohen; vlera e parë jo e zbrazët fiton në këtë renditje: lifetime, mailbox_lifetime, email_lifetime. Vlerat e pavlefshme ose të ndaluara kthejnë HTTP 422 në vend që të zgjedhin në heshtje një parazgjedhje.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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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:17+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:17+00:00",
"email_token": "encrypted-email-token"
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
data.id |
integer | ID e kutisë postare. ID-të, adresat dhe token-et e gjeneruara ndryshojnë për çdo kuti postare. |
data.pin_protected |
boolean | Nëse kjo kuti postare ka mbrojtje me PIN. Asnjë PIN ose hash i PIN-it nuk kthehet. |
data.email |
string | U krijua adresa e plotë e kutisë postare. |
data.domain |
string | Domaini i kutisë postare të gjeneruar. |
data.provider |
string | Furnizuesi i kutisë postare: standard, gmail_alias, ose outlook_alias. |
data.expire_at |
string|null | Skadimi efektiv si një shenjë kohore ISO-8601, ose null për një kuti postare të pakufizuar. |
data.expires_in_seconds |
number|null | Sekondat e mbetura jo negative kur llogariten; sekondat fraksionare janë të mundshme. Null do të thotë i pakufizuar, jo zero. |
data.mailbox_state |
string | Gjendja aktuale e kutisë postare: aktive, e ndalur, e skaduar, ose joaktive. |
data.receiving_enabled |
boolean | Nëse kjo kuti postare aktualisht pranon mesazhe hyrëse. |
data.message_count |
integer | Numri i njohur total i mesazheve; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.unread_message_count |
integer | Numri i njohur i mesazheve të palexuara; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.last_message_received_at |
string|null | Koha e fundit e njohur e mesazhit të marrë në formatin ISO-8601, ose null kur nuk është i disponueshëm. |
data.message_count_synced_at |
string|null | Koha e fundit e sinkronizimit të numrit të mesazheve në formatin ISO-8601, ose null para sinkronizimit. |
data.created_at |
string|null | Koha e krijimit të kutisë postare në formatin ISO-8601. |
data.email_token |
string | Referencë e paqartë e kutisë së postës të enkriptuar. Kjo nuk zëvendëson autentikimin Bearer, kontrollin e pronësisë ose autorizimin me PIN. |
data.pin_grant |
object | Kushtëzuar: krijimi aktiv i kutisë postare të mbrojtur me PIN kthen këtë leje leximi; krijimi i zakonshëm i pambrojtur e lë jashtë. |
data.pin_grant.mailbox_id |
integer | ID-ja e kutisë postare për të cilën është lidhur dhënia e lejes së leximit kushtëzuar. |
data.pin_grant.unlock_token |
string | Token i leximit të paqartë për X-Mailbox-Unlock me kredencialin e të njëjtit pronar. Mbajeni privat dhe në kujtesë; një leje leximi nuk autorizon fshirjen. |
data.pin_grant.scope |
string | Fusha e lexuar për grantin e krijimit kushtëzuar. |
data.pin_grant.idle_timeout_seconds |
integer | Koha e lejuar e papërdorimit për lejen e leximit, normalisht 3600 sekonda. |
data.pin_grant.absolute_timeout_seconds |
integer | Kohëzgjatja maksimale e lejes së leximit, zakonisht 86400 sekonda. |
data.pin_grant.expires_at |
string | Skadimi aktual i lejes së leximit në formatin ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Afati absolut i lejes së leximit në format ISO-8601. Ndryshimet e sigurisë mund të revokojnë lejen më herët. |
Përditëso / Ndërro Kutinë Postare
Krijoni ose zgjidhni një kuti postare në emrin e përdoruesit dhe domenin e ri pasi të keni verifikuar pronësinë e kutisë postare aktuale. Kjo nuk riemëron kutinë postare të vjetër ose ndryshon kohëzgjatjen e saj në vend. Kur destinacioni është i ndryshëm, kutia postare e vjetër mbetet në historik dhe mund të ndalet nga kufizimet e kutive aktive. Ripërpërdorimi i destinacionit tuaj aktiv të vetë aplikon përsëri kohëzgjatjen e kërkuar ose parazgjedhjen e planit.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
email
|
path | string | i nevojshëm |
Adresa e plotë aktuale e email-it të kutisë postare të pronësuar për të ndërruar. Kodoni URL çdo segment të shtigjes; kodoni një shenjë plus si %2B.
|
username
|
path | string | i nevojshëm |
Emri i ri i dëshiruar i përdoruesit: 2 deri në 64 karaktere alfanumerike; i nënshtruar lejes së emrit të përdoruesit të personalizuar.
|
domain
|
path | string | i nevojshëm |
Emër i ri i domenit të lejuar.
|
lifetime
|
body | string | opsionale |
vlerat e lejuara:
10m — 10 Minuta
1h — 1 Orë
2h — 2 Ora
1d — 1 Ditë
1w — 1 javë
1m — 30 Ditë
3m — 90 Ditë
6m — 180 Ditë
1y — 365 Ditë
unlimited — I Pakufishëm
Parazgjedhje:
Kohëzgjatja e paracaktuar e planit
|
pin_enabled
|
body | boolean | opsionale |
Mbrojtje PIN opsionale për kutinë postare të re, kur lejohet nga plani juaj. Nuk ndryshon PIN-in e një kutie postare ekzistuese.
Parazgjedhje:
false
|
pin
|
body | string | opsionale |
Kërkohet kur pin_enabled është i vërtetë: një PIN prej 6 deri në 8 shifra, i dërguar si një varg për të ruajtur zeroet në fillim.
|
pin_confirmation
|
body | string | opsionale |
Kërkohet kur pin_enabled është true. Duhet të përputhet saktësisht me pin.
|
Idempotency-Key
|
header | string | opsionale |
E domosdoshme për krijimin ose fshirjen e mbrojtur me PIN: një çelës i qëndrueshëm me 16 deri në 128 karaktere. Rifilloni kërkesën identike me të njëjtin çelës për të shmangur punë të dyfishtë.
|
X-Mailbox-Unlock
|
header | string | opsionale |
Kreu, vetëm kutitë postare të mbrojtura: përdorni një unlock_token për lexim. Së pari dërgoni POST pin dhe scope=read te URL-ja e çelësimit PIN. Mbani autentikimin tuaj të zakonshëm Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
lifetime (vlerat e lejuara: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Injoro kohëzgjatjen, ose lëre bosh, për të përdorur Kohëzgjatjen e Parazgjedhur të Email-it të konfiguruar për planin tuaj aktual mujor/vjetor. Dërgo një kohëzgjatje të lejuar, si p.sh. 1h, për të anashkaluar atë parazgjedhje. Pa kufi përdoret vetëm kur është konfiguruar si parazgjedhja e planit ose kur kërkohet dhe lejohet në mënyrë të qartë. Parametrat e trupit mailbox_lifetime dhe email_lifetime gjithashtu pranohen; vlera e parë jo e zbrazët fiton në këtë renditje: lifetime, mailbox_lifetime, email_lifetime. Vlerat e pavlefshme ose të ndaluara kthejnë HTTP 422 në vend që të zgjedhin në heshtje një parazgjedhje.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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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:17+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:17+00:00",
"email_token": "encrypted-email-token"
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
data.id |
integer | ID e kutisë postare. ID-të, adresat dhe token-et e gjeneruara ndryshojnë për çdo kuti postare. |
data.pin_protected |
boolean | Nëse kjo kuti postare ka mbrojtje me PIN. Asnjë PIN ose hash i PIN-it nuk kthehet. |
data.email |
string | U krijua adresa e plotë e kutisë postare. |
data.domain |
string | Domaini i kutisë postare të gjeneruar. |
data.provider |
string | Furnizuesi i kutisë postare: standard, gmail_alias, ose outlook_alias. |
data.expire_at |
string|null | Skadimi efektiv si një shenjë kohore ISO-8601, ose null për një kuti postare të pakufizuar. |
data.expires_in_seconds |
number|null | Sekondat e mbetura jo negative kur llogariten; sekondat fraksionare janë të mundshme. Null do të thotë i pakufizuar, jo zero. |
data.mailbox_state |
string | Gjendja aktuale e kutisë postare: aktive, e ndalur, e skaduar, ose joaktive. |
data.receiving_enabled |
boolean | Nëse kjo kuti postare aktualisht pranon mesazhe hyrëse. |
data.message_count |
integer | Numri i njohur total i mesazheve; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.unread_message_count |
integer | Numri i njohur i mesazheve të palexuara; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.last_message_received_at |
string|null | Koha e fundit e njohur e mesazhit të marrë në formatin ISO-8601, ose null kur nuk është i disponueshëm. |
data.message_count_synced_at |
string|null | Koha e fundit e sinkronizimit të numrit të mesazheve në formatin ISO-8601, ose null para sinkronizimit. |
data.created_at |
string|null | Koha e krijimit të kutisë postare në formatin ISO-8601. |
data.email_token |
string | Referencë e paqartë e kutisë së postës të enkriptuar. Kjo nuk zëvendëson autentikimin Bearer, kontrollin e pronësisë ose autorizimin me PIN. |
data.pin_grant |
object | Kushtëzuar: krijimi aktiv i kutisë postare të mbrojtur me PIN kthen këtë leje leximi; krijimi i zakonshëm i pambrojtur e lë jashtë. |
data.pin_grant.mailbox_id |
integer | ID-ja e kutisë postare për të cilën është lidhur dhënia e lejes së leximit kushtëzuar. |
data.pin_grant.unlock_token |
string | Token i leximit të paqartë për X-Mailbox-Unlock me kredencialin e të njëjtit pronar. Mbajeni privat dhe në kujtesë; një leje leximi nuk autorizon fshirjen. |
data.pin_grant.scope |
string | Fusha e lexuar për grantin e krijimit kushtëzuar. |
data.pin_grant.idle_timeout_seconds |
integer | Koha e lejuar e papërdorimit për lejen e leximit, normalisht 3600 sekonda. |
data.pin_grant.absolute_timeout_seconds |
integer | Kohëzgjatja maksimale e lejes së leximit, zakonisht 86400 sekonda. |
data.pin_grant.expires_at |
string | Skadimi aktual i lejes së leximit në formatin ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Afati absolut i lejes së leximit në format ISO-8601. Ndryshimet e sigurisë mund të revokojnë lejen më herët. |
Fshi kutinë postare
Fshini një kutinë postare të zotëruar dhe thirrni pastrimin e mesazheve dhe skedarëve të saj. Regjistrimet e ruajtura të kutisë postare mund të fshihen butësisht brenda; adresa nuk është më e përdorshme përmes API-së.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
email
|
path | string | i nevojshëm |
Adresa e plotë e email-it të kutisë postare në pronësi për t’u fshirë. Kodoni adresën me URL; kodoni një shenjë plus si %2B.
|
X-Mailbox-Unlock
|
header | string | opsionale |
Kreu, vetëm kutitë postare të mbrojtura: përdorni unlock_token për fshirje një herë. Së pari POST pin, scope=delete dhe action/target_id i kthyer nga përgjigja 423 te URL-ja e çelësit PIN. Një token leximi nuk mund të fshijë. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | opsionale |
E domosdoshme për krijimin ose fshirjen e mbrojtur me PIN: një çelës i qëndrueshëm me 16 deri në 128 karaktere. Rifilloni kërkesën identike me të njëjtin çelës për të shmangur punë të dyfishtë.
|
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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
200 OK • JSON{
"status": true,
"message": "Email has been successfully deleted."
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
message |
string | Rezultati i fshirjes. Një burim i munguar kthen HTTP 404. |
Gmail & Outlook Aliase
Krijoni kutia postare alias Gmail dhe Outlook/Hotmail me reputacion të lartë.
Krijo alias Gmail
Krijoni një kuti postare të përkohshme alias Gmail që i përket përdoruesit të autentikuar.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
mode
|
body | string | opsionale |
Mënyra e gjenerimit: auto, dot, plus, ose plus_dot. Pranon gjithashtu gmail_alias_mode. Nëse përzgjedhja e stilit nuk lejohet, përdoret auto.
Parazgjedhje:
auto
|
username
|
body | string | opsionale |
Sufiks opsional i aliasit të personalizuar: 2 deri në 32 shkronja ose shifra ASCII, të normalizuara në shkronja të vogla; i nënshtruar lejes së veçorisë. Gjithashtu pranon custom_username ose alias_username.
Parazgjedhje:
Gjeneruar automatikisht
|
domain
|
body | string | opsionale |
Përdorni rastësisht, gmail.com ose googlemail.com; alias_domain gjithashtu pranohet. Mospërfshirja ose leja për zgjedhje të domenit të padisponueshëm përdor rastësisht.
Parazgjedhje:
random
|
lifetime
|
body | string | opsionale |
vlerat e lejuara:
10m — 10 Minuta
1h — 1 Orë
2h — 2 Ora
1d — 1 Ditë
1w — 1 javë
1m — 30 Ditë
3m — 90 Ditë
6m — 180 Ditë
1y — 365 Ditë
unlimited — I Pakufishëm
Parazgjedhje:
Kohëzgjatja e paracaktuar e planit
|
pin_enabled
|
body | boolean | opsionale |
Mbrojtje PIN opsionale për kutinë postare të re, kur lejohet nga plani juaj. Nuk ndryshon PIN-in e një kutie postare ekzistuese.
Parazgjedhje:
false
|
pin
|
body | string | opsionale |
Kërkohet kur pin_enabled është i vërtetë: një PIN prej 6 deri në 8 shifra, i dërguar si një varg për të ruajtur zeroet në fillim.
|
pin_confirmation
|
body | string | opsionale |
Kërkohet kur pin_enabled është true. Duhet të përputhet saktësisht me pin.
|
Idempotency-Key
|
header | string | opsionale |
E domosdoshme për krijimin ose fshirjen e mbrojtur me PIN: një çelës i qëndrueshëm me 16 deri në 128 karaktere. Rifilloni kërkesën identike me të njëjtin çelës për të shmangur punë të dyfishtë.
|
mode (auto, dot, plus, plus_dot), username (pseudonim i personalizuar i përdoruesit), domain (p.sh. gmail.com, googlemail.com), lifetime (vlerat e lejuara: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Injoro kohëzgjatjen, ose lëre bosh, për të përdorur Kohëzgjatjen e Parazgjedhur të Email-it të konfiguruar për planin tuaj aktual mujor/vjetor. Dërgo një kohëzgjatje të lejuar, si p.sh. 1h, për të anashkaluar atë parazgjedhje. Pa kufi përdoret vetëm kur është konfiguruar si parazgjedhja e planit ose kur kërkohet dhe lejohet në mënyrë të qartë. Parametrat e trupit mailbox_lifetime dhe email_lifetime gjithashtu pranohen; vlera e parë jo e zbrazët fiton në këtë renditje: lifetime, mailbox_lifetime, email_lifetime. Vlerat e pavlefshme ose të ndaluara kthejnë HTTP 422 në vend që të zgjedhin në heshtje një parazgjedhje.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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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:17+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:17+00:00",
"email_token": "encrypted-email-token"
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
data.id |
integer | ID e kutisë postare. ID-të, adresat dhe token-et e gjeneruara ndryshojnë për çdo kuti postare. |
data.pin_protected |
boolean | Nëse kjo kuti postare ka mbrojtje me PIN. Asnjë PIN ose hash i PIN-it nuk kthehet. |
data.email |
string | U krijua adresa e plotë e kutisë postare. |
data.domain |
string | Domaini i kutisë postare të gjeneruar. |
data.provider |
string | Furnizuesi i kutisë postare: standard, gmail_alias, ose outlook_alias. |
data.expire_at |
string|null | Skadimi efektiv si një shenjë kohore ISO-8601, ose null për një kuti postare të pakufizuar. |
data.expires_in_seconds |
number|null | Sekondat e mbetura jo negative kur llogariten; sekondat fraksionare janë të mundshme. Null do të thotë i pakufizuar, jo zero. |
data.mailbox_state |
string | Gjendja aktuale e kutisë postare: aktive, e ndalur, e skaduar, ose joaktive. |
data.receiving_enabled |
boolean | Nëse kjo kuti postare aktualisht pranon mesazhe hyrëse. |
data.message_count |
integer | Numri i njohur total i mesazheve; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.unread_message_count |
integer | Numri i njohur i mesazheve të palexuara; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.last_message_received_at |
string|null | Koha e fundit e njohur e mesazhit të marrë në formatin ISO-8601, ose null kur nuk është i disponueshëm. |
data.message_count_synced_at |
string|null | Koha e fundit e sinkronizimit të numrit të mesazheve në formatin ISO-8601, ose null para sinkronizimit. |
data.created_at |
string|null | Koha e krijimit të kutisë postare në formatin ISO-8601. |
data.email_token |
string | Referencë e paqartë e kutisë së postës të enkriptuar. Kjo nuk zëvendëson autentikimin Bearer, kontrollin e pronësisë ose autorizimin me PIN. |
data.pin_grant |
object | Kushtëzuar: krijimi aktiv i kutisë postare të mbrojtur me PIN kthen këtë leje leximi; krijimi i zakonshëm i pambrojtur e lë jashtë. |
data.pin_grant.mailbox_id |
integer | ID-ja e kutisë postare për të cilën është lidhur dhënia e lejes së leximit kushtëzuar. |
data.pin_grant.unlock_token |
string | Token i leximit të paqartë për X-Mailbox-Unlock me kredencialin e të njëjtit pronar. Mbajeni privat dhe në kujtesë; një leje leximi nuk autorizon fshirjen. |
data.pin_grant.scope |
string | Fusha e lexuar për grantin e krijimit kushtëzuar. |
data.pin_grant.idle_timeout_seconds |
integer | Koha e lejuar e papërdorimit për lejen e leximit, normalisht 3600 sekonda. |
data.pin_grant.absolute_timeout_seconds |
integer | Kohëzgjatja maksimale e lejes së leximit, zakonisht 86400 sekonda. |
data.pin_grant.expires_at |
string | Skadimi aktual i lejes së leximit në formatin ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Afati absolut i lejes së leximit në format ISO-8601. Ndryshimet e sigurisë mund të revokojnë lejen më herët. |
Domainet Alias të Outlook
Merrni domenet e aliasëve aktive Outlook / Hotmail të disponueshme për krijimin e kutisë postare.
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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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
}
]
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
data.domains |
array | Domainet aktive Outlook/Hotmail; një varg i zbrazët është i vlefshëm. |
data.domains[].domain |
string | Emri i domenit të disponueshëm. |
data.domains[].type |
string | Etiketa e ofruesit e lexueshme. |
data.domains[].selectable |
boolean | Nëse llogaria juaj mund të zgjedhë në mënyrë të qartë këtë domen. |
data.domains[].locked |
boolean | Nëse përzgjedhja e qartë e domain-it është e bllokuar për llogarinë tuaj. |
data.domains[].disabled_reason |
string|null | Arsyeja përse përzgjedhja e domenit është e bllokuar, ose null kur është e përzgjedhshme. |
Krijo Alias Outlook
Krijoni një kuti postare të përkohshme alias Outlook / Hotmail që i përket përdoruesit të autentikuar.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
domain
|
body | string | opsionale |
Përdorni rastësisht ose një domain nga GET /outlook-alias/domains; outlook_alias_domain gjithashtu pranohet. Pa leje përzgjedhjeje, përdoret rastësisht.
Parazgjedhje:
Domain i rastësishëm i disponueshëm
|
username
|
body | string | opsionale |
Sufiks opsional i aliasit të personalizuar: 2 deri në 32 shkronja ose shifra ASCII, të normalizuara në shkronja të vogla; i nënshtruar lejes së veçorisë. Gjithashtu pranon custom_username ose alias_username.
Parazgjedhje:
Gjeneruar automatikisht
|
lifetime
|
body | string | opsionale |
vlerat e lejuara:
10m — 10 Minuta
1h — 1 Orë
2h — 2 Ora
1d — 1 Ditë
1w — 1 javë
1m — 30 Ditë
3m — 90 Ditë
6m — 180 Ditë
1y — 365 Ditë
unlimited — I Pakufishëm
Parazgjedhje:
Kohëzgjatja e paracaktuar e planit
|
pin_enabled
|
body | boolean | opsionale |
Mbrojtje PIN opsionale për kutinë postare të re, kur lejohet nga plani juaj. Nuk ndryshon PIN-in e një kutie postare ekzistuese.
Parazgjedhje:
false
|
pin
|
body | string | opsionale |
Kërkohet kur pin_enabled është i vërtetë: një PIN prej 6 deri në 8 shifra, i dërguar si një varg për të ruajtur zeroet në fillim.
|
pin_confirmation
|
body | string | opsionale |
Kërkohet kur pin_enabled është true. Duhet të përputhet saktësisht me pin.
|
Idempotency-Key
|
header | string | opsionale |
E domosdoshme për krijimin ose fshirjen e mbrojtur me PIN: një çelës i qëndrueshëm me 16 deri në 128 karaktere. Rifilloni kërkesën identike me të njëjtin çelës për të shmangur punë të dyfishtë.
|
domain (p.sh. outlook.com, hotmail.com), username (pseudonim i personalizuar i përdoruesit), lifetime (vlerat e lejuara: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Injoro kohëzgjatjen, ose lëre bosh, për të përdorur Kohëzgjatjen e Parazgjedhur të Email-it të konfiguruar për planin tuaj aktual mujor/vjetor. Dërgo një kohëzgjatje të lejuar, si p.sh. 1h, për të anashkaluar atë parazgjedhje. Pa kufi përdoret vetëm kur është konfiguruar si parazgjedhja e planit ose kur kërkohet dhe lejohet në mënyrë të qartë. Parametrat e trupit mailbox_lifetime dhe email_lifetime gjithashtu pranohen; vlera e parë jo e zbrazët fiton në këtë renditje: lifetime, mailbox_lifetime, email_lifetime. Vlerat e pavlefshme ose të ndaluara kthejnë HTTP 422 në vend që të zgjedhin në heshtje një parazgjedhje.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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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:17+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:17+00:00",
"email_token": "encrypted-email-token"
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
data.id |
integer | ID e kutisë postare. ID-të, adresat dhe token-et e gjeneruara ndryshojnë për çdo kuti postare. |
data.pin_protected |
boolean | Nëse kjo kuti postare ka mbrojtje me PIN. Asnjë PIN ose hash i PIN-it nuk kthehet. |
data.email |
string | U krijua adresa e plotë e kutisë postare. |
data.domain |
string | Domaini i kutisë postare të gjeneruar. |
data.provider |
string | Furnizuesi i kutisë postare: standard, gmail_alias, ose outlook_alias. |
data.expire_at |
string|null | Skadimi efektiv si një shenjë kohore ISO-8601, ose null për një kuti postare të pakufizuar. |
data.expires_in_seconds |
number|null | Sekondat e mbetura jo negative kur llogariten; sekondat fraksionare janë të mundshme. Null do të thotë i pakufizuar, jo zero. |
data.mailbox_state |
string | Gjendja aktuale e kutisë postare: aktive, e ndalur, e skaduar, ose joaktive. |
data.receiving_enabled |
boolean | Nëse kjo kuti postare aktualisht pranon mesazhe hyrëse. |
data.message_count |
integer | Numri i njohur total i mesazheve; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.unread_message_count |
integer | Numri i njohur i mesazheve të palexuara; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
data.last_message_received_at |
string|null | Koha e fundit e njohur e mesazhit të marrë në formatin ISO-8601, ose null kur nuk është i disponueshëm. |
data.message_count_synced_at |
string|null | Koha e fundit e sinkronizimit të numrit të mesazheve në formatin ISO-8601, ose null para sinkronizimit. |
data.created_at |
string|null | Koha e krijimit të kutisë postare në formatin ISO-8601. |
data.email_token |
string | Referencë e paqartë e kutisë së postës të enkriptuar. Kjo nuk zëvendëson autentikimin Bearer, kontrollin e pronësisë ose autorizimin me PIN. |
data.pin_grant |
object | Kushtëzuar: krijimi aktiv i kutisë postare të mbrojtur me PIN kthen këtë leje leximi; krijimi i zakonshëm i pambrojtur e lë jashtë. |
data.pin_grant.mailbox_id |
integer | ID-ja e kutisë postare për të cilën është lidhur dhënia e lejes së leximit kushtëzuar. |
data.pin_grant.unlock_token |
string | Token i leximit të paqartë për X-Mailbox-Unlock me kredencialin e të njëjtit pronar. Mbajeni privat dhe në kujtesë; një leje leximi nuk autorizon fshirjen. |
data.pin_grant.scope |
string | Fusha e lexuar për grantin e krijimit kushtëzuar. |
data.pin_grant.idle_timeout_seconds |
integer | Koha e lejuar e papërdorimit për lejen e leximit, normalisht 3600 sekonda. |
data.pin_grant.absolute_timeout_seconds |
integer | Kohëzgjatja maksimale e lejes së leximit, zakonisht 86400 sekonda. |
data.pin_grant.expires_at |
string | Skadimi aktual i lejes së leximit në formatin ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Afati absolut i lejes së leximit në format ISO-8601. Ndryshimet e sigurisë mund të revokojnë lejen më herët. |
Mesazhe & Bashkëngjitje
Merr kutitë hyrëse, lexoni mesazhet e plota HTML/tekst dhe transmetoni bashkëngjitjet.
Listo Mesazhet e Kutit Postare
Merr përmbledhjet e disponueshme të mesazheve dhe metadatat e kutisë postare. Skanimet standarde të kutisë hyrëse kthejnë një grup të fundit të deri në 25 mesazhe; kjo nuk është një pikë fundore e historikut të plotë me faqosje. Përdor GET /messages/{messageId} për trupat e plotë dhe bashkëngjitjet.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
email
|
query | string | i nevojshëm |
Adresa e plotë e email-it të kutisë postare të pronësuar për të lexuar mesazhet. Kodoni URL vlerën e kërkimit; kodoni një shenjë plus si %2B.
|
X-Mailbox-Unlock
|
header | string | opsionale |
Kreu, vetëm kutitë postare të mbrojtura: përdorni një unlock_token për lexim. Së pari dërgoni POST pin dhe scope=read te URL-ja e çelësimit PIN. Mbani autentikimin tuaj të zakonshëm Bearer. <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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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:17",
"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:17+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:17+00:00",
"message_count_synced_at": "2026-11-19T02:18:17+00:00"
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
mailbox |
string | Adresa e kutisë postare për të cilën u kërkuan mesazhet. |
email_token |
string | Referencë e panjohur të kutisë postare të enkriptuar; autentikimi normal është ende i nevojshëm. |
mailbox_provider |
string | Furnizuesi i kutisë postare: standard, gmail_alias, ose outlook_alias. |
messages |
array | Përmbledhje mesazhesh. Një kutia e postës e zbrazët kthen një varg të zbrazët; merrni një mesazh të vetëm për trupin dhe bashkëngjitjet e tij. |
expire_at |
string|null | Skadimi efektiv si një shenjë kohore ISO-8601, ose null për një kuti postare të pakufizuar. |
expires_in_seconds |
number|null | Sekondat e mbetura jo negative kur llogariten; sekondat fraksionare janë të mundshme. Null do të thotë i pakufizuar, jo zero. |
mailbox_state |
string | Gjendja aktuale e kutisë postare: aktive, e ndalur, e skaduar, ose joaktive. |
receiving_enabled |
boolean | Nëse kjo kuti postare aktualisht pranon mesazhe hyrëse. |
message_count |
integer | Numri i njohur total i mesazheve; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
unread_message_count |
integer | Numri i njohur i mesazheve të palexuara; mund të pasqyrojë sinkronizimin e fundit të kutisë postare. |
last_message_received_at |
string|null | Koha e fundit e njohur e mesazhit të marrë në formatin ISO-8601, ose null kur nuk është i disponueshëm. |
message_count_synced_at |
string|null | Koha e fundit e sinkronizimit të numrit të mesazheve në formatin ISO-8601, ose null para sinkronizimit. |
mailbox_limit.limit |
integer | Kufiri aktiv i kutisë postare për këtë ofrues; -1 do të thotë i pakufizuar. |
mailbox_limit.limit_label |
string | Etiketa e shfaqur për kufirin e kutisë postare. |
mailbox_limit.active_count |
integer | Numri i kutive postare aktive për këtë ofrues. |
mailbox_limit.paused_count |
integer | Numri i kutive postare të ndaluara për këtë ofrues. |
mailbox_limit.paused_mailboxes |
array<string> | Adresat janë ndalur për shkak të kufirit të kutisë postare. |
mailbox_limit.remaining |
integer | Slotet e mbetura të kutisë së postës aktive; -1 do të thotë i pakufizuar. Kjo nuk është kuota e kërkesave API. |
mailbox_limit.remaining_label |
string | Shfaq etiketën për vendet e mbetura të kutisë postare. |
mailbox_limit.reached |
boolean | Nëse është arritur kufiri i kutisë postare aktive. |
mailbox_limit.blocked |
boolean | Nëse kufiri aktiv i kutisë së postës është zero. |
mailbox_limit.provider |
string|null | Furnizuesi për të cilin vlen kufiri i kutisë postare. |
messages[].id |
string | ID e mesazhit të paqartë e përdorur nga fundpunktet e mesazhit të vetëm, fshirjes dhe bashkëngjitjes. |
messages[].is_seen |
boolean | Nëse mesazhi është shënuar si i lexuar. |
messages[].subject |
string | Subjekti i mesazhit. |
messages[].from |
string | Emri i shfaqur i dërguesit ose adresa. |
messages[].from_email |
string | Adresa e email-it të dërguesit. |
messages[].receivedAt |
string | Koha e marrë në zonën kohore të aplikacionit, e formatizuar si YYYY-MM-DD HH:mm:ss. |
messages[].otp |
string|null | U zbulua kod njëherësh kur është i disponueshëm dhe i lejuar; përndryshe null. |
messages[].otp_locked |
boolean | Nëse një kod njëpërdorues i zbuluar është i fshehur nga lejet e funksionit. |
messages[].verification_link |
string|null | U zbulua URL e verifikimit kur është i disponueshëm dhe i lejuar; përndryshe null. |
messages[].verification_link_locked |
boolean | Nëse një lidhje verifikimi e zbuluar është e fshehur nga lejet e veçorive. |
messages[].from_name |
string|null | Fusha e përmbledhjes Outlook: emri i dërguesit origjinal. Mungon nga përmbledhjet Standard dhe Gmail. |
messages[].snippet |
string|null | Fusha e përmbledhjes Outlook: paraprak i shkurtër i mesazhit. |
messages[].received_at |
string|null | Fusha e përmbledhjes Outlook: koha e marrë në format ISO-8601, kur është e njohur. |
messages[].has_attachments |
boolean | Fusha e përmbledhjes Outlook: nëse ekzistojnë metadata të bashkëngjitjeve. Disponueshmëria e shkarkimit kontrollohet veçmas. |
Merr Mesazhin e Vetëm
Merrni një mesazh të zotëruar sipas ID-së së tij të paqartë të mesazhit. Kthen formatet e trupit dhe metadata e bashkëngjitjeve. Fushat e trupit varen nga formati i mesazhit; Outlook shton fushat specifike të ofruesit të listuara më poshtë.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
messageId
|
path | string | i nevojshëm |
ID-ja unike e mesazhit e kthyer në listën e mesazheve.
|
X-Mailbox-Unlock
|
header | string | opsionale |
Kreu, vetëm kutitë postare të mbrojtura: përdorni një unlock_token për lexim. Së pari dërgoni POST pin dhe scope=read te URL-ja e çelësimit PIN. Mbani autentikimin tuaj të zakonshëm Bearer. <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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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:17",
"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"
}
]
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
data.id |
string | ID e mesazhit opak. |
data.is_seen |
boolean | Gjendja e leximit të mesazhit. Leximi mund ta shënojë si i parë; të dhënat e ruajtura në cache mund të pasqyrojnë një gjendje më të hershme. |
data.subject |
string | Subjekti i mesazhit. |
data.from |
string | Emri i shfaqur i dërguesit ose adresa. |
data.from_email |
string | Adresa e email-it të dërguesit. |
data.to |
string | Adresa e kutisë postare të marrësit. |
data.mailbox_provider |
string | Furnizuesi i kutisë postare: standard, gmail_alias, ose outlook_alias. |
data.receivedAt |
string | Koha e marrë në zonën kohore të aplikacionit, e formatizuar si YYYY-MM-DD HH:mm:ss. |
data.html |
boolean | Nëse mesazhi ka një trup HTML. |
data.html_content |
string | Trupi HTML kur është i pranishëm. Mesazhet standarde pa HTML mund ta injorojnë këtë fushë. Trajtoni përmbajtjen e mesazhit si të pa besueshme. |
data.text_content |
string | Trupi i tekstit kur është i pranishëm; Mesazhet standarde mund të përmbajnë tekst i ikur në një element pre ose të injorojnë këtë fushë. |
data.content |
string | Trupi i preferuar për shfaqje, zakonisht HTML kur është i disponueshëm. |
data.attachments |
array | Metadata e bashkëngjitjes, ose një varg i zbrazët. Shkarkimet kërkojnë autentikim normal dhe autorizim të aplikueshëm të PIN-it. |
data.attachments[].name |
string | Emri i skedarit për t’u koduar në URL si një segment i vetëm i shtigjes kur shkarkohet. |
data.attachments[].size |
integer | Madhësia e bashkëngjitjes në bajte. |
data.attachments[].url |
string | URL-ja e shkarkimit të API-së së përdoruesit të autentikuar u shtua te bashkëngjitjet me një emër skedari. Një URL nuk garanton që skedari lokal është i disponueshëm. |
data.attachments[].extension |
string | Fushë metadata standarde/Gmail: prapashtesa e skedarit kur jepet. |
data.attachments[].id |
string | Fushë metadata Outlook: ID e bashkëngjitjes së ofruesit. |
data.attachments[].content_type |
string | Fusha e metadata në Outlook: lloji i përmbajtjes MIME. |
data.from_name |
string|null | Fusha e detajit në Outlook: emri i dërguesit origjinal. |
data.to_email |
string|null | Fusha e detajit në Outlook: adresa e marrësit origjinal. |
data.received_at |
string|null | Fusha e detajuar e Outlook: koha e marrë në formatin ISO-8601. |
data.has_html |
boolean | Fusha e detajit në Outlook: nëse ekziston një trup HTML. |
Fshi Mesazhin
Fshij një mesazh të vetëm të pronësuar.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
messageId
|
path | string | i nevojshëm |
Varg unik i ID-së së mesazhit për fshirje të përhershme.
|
X-Mailbox-Unlock
|
header | string | opsionale |
Kreu, vetëm kutitë postare të mbrojtura: përdorni unlock_token për fshirje një herë. Së pari POST pin, scope=delete dhe action/target_id i kthyer nga përgjigja 423 te URL-ja e çelësit PIN. Një token leximi nuk mund të fshijë. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | opsionale |
E domosdoshme për krijimin ose fshirjen e mbrojtur me PIN: një çelës i qëndrueshëm me 16 deri në 128 karaktere. Rifilloni kërkesën identike me të njëjtin çelës për të shmangur punë të dyfishtë.
|
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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
200 OK • JSON{
"status": true,
"message": "Message was deleted successfully."
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
status |
boolean | Nëse operacioni pati sukses. |
message |
string | Rezultati i fshirjes. Një burim i munguar kthen HTTP 404. |
Shkarko Bashkëngjitjen
Shkarko një shtojcë nga një mesazh i pronësuar.
| Parametër | Vendndodhja | Lloj | Status | Përshkrimi |
|---|---|---|---|---|
messageId
|
path | string | i nevojshëm |
ID i mesazhit që përmban skedarin.
|
filename
|
path | string | i nevojshëm |
Emri i skedarit dhe zgjatja e bashkëngjitjes për t'u shkarkuar.
|
X-Mailbox-Unlock
|
header | string | opsionale |
Kreu, vetëm kutitë postare të mbrojtura: përdorni një unlock_token për lexim. Së pari dërgoni POST pin dhe scope=read te URL-ja e çelësimit PIN. Mbani autentikimin tuaj të zakonshëm Bearer. <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
| Fushë | Lloj | Përshkrimi |
|---|---|---|
Content-Disposition |
header | Përgjigja e suksesshme shkarkon emrin e skedarit të kërkuar. |
body |
binary | Bajtë të skedarit në sukses, jo JSON. Gabimet kthejnë JSON me status jo-2xx. |
Kufizimet e Shpejtësisë & Kuotat
Monitoroni buxhetet e kërkesave në kohë reale, kufizimet e shpejtësisë dhe kuotat e llogarisë pa konsumuar kredite.
Kufiri i Shpejtësisë & Kuota
Kontrolloni kufirin aktual të shpejtësisë dhe statusin e kuotës pa konsumuar ndonjë përdorim të API-së. Ky pikë fundi është pa kuota dhe nuk zbrit kredite mujore të API-së (kufiri i mbrojtjes kundër abuzimit: 60 kërkesa/min).
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'
Përgjigje ilustrative duke përdorur të dhëna sintetike. ID-të, adresat, token-et, shenjat kohore, kufizimet dhe numrat e planit ndryshojnë. Kohëjet e mostrave nuk anashkalojnë parazgjedhjen e planit tuaj. Përshkrimet e fushave të përgjigjes identifikojnë fushat që mund të jenë null dhe ato specifike për ofruesin.
Përgjigje e shembullit
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"
}
}
}
| Fushë | Lloj | Përshkrimi |
|---|---|---|
data.limit |
integer|string | Kufiri i kërkesave për llogari në minutë. Vargu 'unlimited' tregon një buxhet të pakufizuar për minutë; kjo është e pavarur nga kuota mujore. |
data.remaining |
integer|string | Slotet e mbetura të buxhetit në minuta të llogarisë, ose vargu unlimited. Një vlerë pozitive nuk do të thotë se kreditë e API-së mbeten. |
data.reset |
integer | Sekondat për dritaren e minutës së llogarisë, jo për rivendosjen e kuotës mujore. Buxhetet e minutave të çaktivizuara ose të pakufizuara mund të mbajnë një vlerë nominale prej 60 sekondash; kjo nuk premton akses pas pritjes. |
data.plan |
string | Etiketa e planit aktual. Emri i lexueshëm i planit jepet veçmas në data.quota.plan_name. |
data.quota.enabled |
boolean | Nëse qasja globale dhe e planit/kreditit në API është e aktivizuar. Kjo nuk tregon kapacitetin e mbetur ose zëvendëson çelësin e API-së së përdoruesit. |
data.quota.user_api_status |
boolean | Nëse përdoruesi ka aktivizuar çelësin e API-së së përdoruesit. Operacionet kërkojnë këtë çelës, si dhe akses të aktivizuar dhe kapacitet të disponueshëm. |
data.quota.plan_name |
string | Emri i lexueshëm i planit aktual. |
data.quota.period |
string | Periudha e përdorimit kalendar-muaj në formatin YYYY-MM, duke përdorur zonën kohore të aplikacionit; jo domosdoshmërisht periudha e faturimit të abonimit. |
data.quota.base_limit |
integer | Leja bazë mujore e planit. Një vlerë -1 do të thotë e pakufizuar. |
data.quota.extra_requests |
integer | Leje shtesë mujore e dhënë për periudhën aktuale të përdorimit; e veçantë nga kreditë e blera. |
data.quota.monthly_limit |
integer | Leja bazë plus kërkesat shtesë të periudhës aktuale. Një vlerë -1 do të thotë i pakufizuar. Kreditët e blerë nuk përfshihen. |
data.quota.monthly_remaining |
integer|null | Leja mujore e mbetur e kufizuar, ose null kur kuota mujore është e pakufizuar. Null nuk duhet të interpretohet si zero. |
data.quota.used |
integer | Veprimet e API-së të suksesshme, të numëruara në periudhën aktuale të përdorimit, duke përfshirë veprimet që përdorin kredi. Kontrollimet e statusit nuk rrisin këtë vlerë. |
data.quota.purchased_credits |
integer | Bilanci aktual i kredive, duke përfshirë kreditë bonus të planit aktiv. Kreditët bonus nuk duhet të shtohen në këtë bilanc për herë të dytë. |
data.quota.bonus_credits |
integer | Pjesa aktive e planit-bonus e balancës së kreditit; një ndarje e purchased_credits, jo kapacitet shtesë. |
data.quota.direct_purchased_credits |
integer | Bilanci i kreditëve përjashton pjesën aktive të planit-bonus. Kjo vlerë plus bonus_credits është e barabartë me purchased_credits. |
data.quota.remaining |
integer|null | Leja e mbetur mujore plus balanca aktuale e kreditit, pa numëruar dy herë bonuset. Null do të thotë kuotë mujore e pakufizuar. Lejet individuale të veçorive dhe kufizimet e tjera të kërkesave vazhdojnë të zbatohen. |
data.quota.unlimited |
boolean | Nëse kuota mujore është e pakufizuar. Kjo nuk bën buxhetin e minutave të llogarisë ose kufizimet e tjera të veçorive të pakufizuara. |
data.quota.usage_percent |
integer | Procent i rrumbullakosur, i përputhshëm me panelin, nga 0 në 100: përdorur i ndarë me përdorur plus mbetja, i shumëzuar me 100. Përfshin kapacitetin e kreditit të disponueshëm, kështu që rimbushja mund të ulë përqindjen. Është 0 për kuotë e pakufizuar ose një grup me madhësi zero; nuk është përqindja e kufirit të shpejtësisë për minutë ose një vendim qasjeje. |
data.quota.reset_at |
string | Vulë kohore ISO-8601 me ofset zonë kohore për rivendosjen e kuotës së muajit kalendarik të ardhshëm. Kjo nuk është data e skadimit të abonimit, dhe rivendosja mujore nuk rimbush kreditët e blerë. |
status |
string | Suksesi literal për këtë pikë fundore të statusit. Pikë fundore të tjera të suksesshme të kutisë postare përdorin vërtetën booleane. |
data.monthly_limit |
integer | Alias i përputhshmërisë i fushës përkatëse data.quota; mos e shtoni përsëri kur llogaritni bilancet. |
data.monthly_remaining |
integer|null | Alias i përputhshmërisë i fushës përkatëse data.quota; mos e shtoni përsëri kur llogaritni bilancet. |
data.purchased_credits |
integer | Alias i përputhshmërisë i fushës përkatëse data.quota; mos e shtoni përsëri kur llogaritni bilancet. |
Webhooks për Postë Elektronike (Push në Tempo Real)
Në vend të kërkimit të përsëritur të API REST (GET /messages) për të kontrolluar për email të ardhshëm, konfiguroni webhook për të dërguar mesazhe të reja drejt serverit të juaj ose në një proces automatizimi në kohë reale.
Ngjarjet Webhook të mbështetura
Çdo webhook mund të abonohet për një ose më shumë lloje ngjarjesh. Endpoint-i juaj merr një njoftim ngjarjeje sa herë që një nga këto trigger-e aktivizohet.
Dërgohet në kohë reale sa herë që një mesazh i ri arrin në kutinë postare të zgjedhur.
Dërgohet kur kutia postare e përkohshme skadon dhe përpunimi i webhook-ut ndalet.
Dërgohet kur një kutia postare e skaduar bëhet përsëri aktive sipas rregullave të planit.
Dërguar menjëherë para se webhook-u dhe kutia e tij postare të fshihen.
Kërkesa e Kofshave dhe Verifikimi i Shënimit HMAC
Çdo dorëzime webhook përmban kofçe të sigurisë specifike. Përdorni kofçën **X-TempMailg-Signature** për të verifikuar se kërkesat hyrëse janë dërguar në mënyrë autentike nga TempMailg dhe nuk janë modifikuar.
| Emri i Kufomës | Vlerëzim shembull | Përshkrimi |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Identifikator standard për punonjësin e dërgimit të webhook-ut. |
X-TempMailg-Event |
email.received | Lloji i ngjarjes që shkaktoi këtë dërgim. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | UUID i veçantë i caktuar për këtë përpjekje dërgimi. |
X-TempMailg-Timestamp |
1725192000 | Vulë kohore Unix epoch që tregon kur u nis kërkesa. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | Nënshkrimi HMAC-SHA256 i llogaritur nga {timestamp}.{raw_body} duke përdorur sekretin tuaj. |
X-TempMailg-Test |
false | E vërtetë kur dërgohet nga funksioni "Send Test Ping" në pultin tuaj. |
Shkruaja nënshkruesja me përdorim të HMAC me SHA256 mbi stringun:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Përmbledhje Shkallëzuesi i Ngjarjes (email.received)
Transmetuar si aplikacion JSON në trupin e kërkesës HTTP POST.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:18:18+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:18:18+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"
}
}
Shembuj të Zbatimit të Marrësit
Zgjidhni gjuhën tuaj për të parë se si të merrni webhook-et dhe të verifikoni nënshkrimet HMAC në mënyrë të sigurt.
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]);
Platforma të Mbështetura & Integrime të Automatizimit
Webhooks e TempMailg funksionojnë menjëherë me pikat fundore standarde HTTPS dhe platformat kryesore pa kod/automatizim:
Gabimet e zakonshme dhe zgjidhja e problemeve
Këto janë kodet më të zakonshme të përgjigjes që mund të shihni gjatë integrimi të API të përdoruesit.
Token i Bearer i pavlefshëm, i munguar ose i revokuar.
Pronësia, lejet e veçorive, qasja në domen ose madhësia e bashkëngjitjes penguan veprimin. Kontrolloni kodin e përgjigjes dhe mesazhin.
Rezerva nuk u gjet në hostin e lejuar ose nuk i përket përdoruesit.
Kyçi i operacionit u ripërdor me detaje të ndryshme, një operacion tjetër është në pritje, ose siguria e kutisë postare ndryshoi. Kontrolloni kodin para se të provoni përsëri.
Kutia postare skaduar ose e paaktivizuar.
Parametra të pavlefshëm, një kohëzgjatje e ndaluar, kapacitet alias i padisponueshëm, konfigurim i PIN-it i pavlefshëm ose mungesa/e pavlefshmëria e Idempotency-Key parandaloi operacionin.
Një kuti postare e mbrojtur ka nevojë për një token të vlefshëm X-Mailbox-Unlock me shtrirje. Përdorni veprimin dhe target_id nga përgjigja për fshirjen. Kërkesat për bllokim ose rimarrje duhet të zgjidhen përpara riprovimit.
Një kufi i kërkesës, plan i çaktivizuar, kuota e shteruar, ose periudha e ftohjes pengoi veprimin. Kontrolloni arsyen dhe titrat e buxhetit të disponueshëm. Retry-After është opsional.
Serveri nuk mundi të përfundojë veprimin. Për krijim ose fshirje të mbrojtur, ruani të njëjtën kërkesë dhe Idempotency-Key kur riprovoni.
Ruajtja e mbrojtjes ose koordinimi nuk mund të verifikohet. Riprovoni pas vonesës së treguar. Kjo përgjigje nuk është një pagesë e dështuar.
Kontrolli i shpejtë
- 401 Unauthorized - Tokeni Bearer mungon, është i gabuar, i anuluar ose i kopjuar gabimisht.
- 403 Forbidden - Plani aktual nuk ka të drejtë hyrjeje në API të përdoruesit për momentin.
- 404 Not Found - Ressursa nuk u gjet ose parametri është i pavlefshëm
- 410 Gone / Expired - Kutia postare ka skaduar ose nuk është më aktive.
- 429 Rate Limited - Kontrolloni arsyen e përgjigjes dhe titrat e buxhetit. Retry-After zbatohet vetëm për kufijtë kohorë; kreditet e shteruara ose akses i çaktivizuar mund të kërkojnë një ndryshim të llogarisë.
Hap i radhës i rekomanduar
Nëse jeni të kyçur, hapni API Management së pari dhe konfirmoni statusin e çeljes suaj, kuotës, planit të aksesit dhe URL bazë të saktë të API të përdoruesit para se të degëzoni aplikacionin tuaj të jashtëm.