Dokumentacioni i API-ve të TempMail

REST API v1 & Webhooks

TempMailg Dokumentacioni i API-së për Zhvillues

Përdorni këtë dokumentacion për të gjeneruar çelësin tuaj personal API, lidhjen me hostin e API-ve të përdoruesit, lexoni mesazhet e kutisë postare, menaxhoni kutitë postare të pronësuara dhe integroni Temp Mail në aplikacionet ose automatizimet tuaja.

Autentikim me Token Webhook-e në Kohë Reale Gmail & Outlook Aliase Përgjigjet JSON
URL Baza e API të Përdoruesit HTTPS
Format i kërkesës Përdorni çelësin tuaj API vetëm në header-in e Autorizimit Bearer dhe mbani URL-të pastër të pikënisjes.

Menaxhim i kutisë postare

Merr domene të lejuara, krijo ose ndrysho kutitë postare, zgjidh jetëgjatësitë e lejuara, dhe fshi adresat e pronuara.

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

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.

Parametrat 1
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
Merr domene të lejuara
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
            }
        ]
    }
}
Fushat e përgjigjes
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.
POST https://v1.tempmailg.com/api/emails
#

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.

Parametrat 8
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ë.
Parametra opsionalë të trupit: 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.
Krijo kutinë postare
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"
    }
}
Fushat e përgjigjes
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.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

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.

Parametrat 9
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>
Përdor një kuti postare ekzistuese të pronësuar në {email}. Parametër opsional i trupit: 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.
Përditëso kuti postare të pronësuar
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"
    }
}
Fushat e përgjigjes
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.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

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ë.

Parametrat 3
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ë.
Fshij kuti postare të pronësuar
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."
}
Fushat e përgjigjes
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ë.

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

Krijo alias Gmail

Krijoni një kuti postare të përkohshme alias Gmail që i përket përdoruesit të autentikuar.

Parametrat 8
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ë.
Kërkon lejen Gmail Alias API të aktivizuar në planin tuaj të abonimit ose të ç'kyçur përmes një pakete API Credit. Parametra opsionalë: 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.
Krijo kutinë postare alias Gmail
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"
    }
}
Fushat e përgjigjes
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.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Domainet Alias të Outlook

Merrni domenet e aliasëve aktive Outlook / Hotmail të disponueshme për krijimin e kutisë postare.

Kërkon lejen Outlook Alias API të aktivizuar në planin tuaj të abonimit ose të zhbllokuar përmes një pakete Krediti API. Tregon nëse përzgjedhja e domenit specifik është e ç'kyçur në planin tuaj.
Merr domenet e aliasit Outlook
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
            }
        ]
    }
}
Fushat e përgjigjes
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.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Krijo Alias Outlook

Krijoni një kuti postare të përkohshme alias Outlook / Hotmail që i përket përdoruesit të autentikuar.

Parametrat 7
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ë.
Kërkon lejen Outlook Alias API të aktivizuar në planin tuaj të abonimit ose të zhbllokuar përmes një pakete Krediti API. Parametra opsionalë: 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.
Krijo kutinë postare alias Outlook
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"
    }
}
Fushat e përgjigjes
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.

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

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.

Parametrat 2
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>
Email-i duhet të përket llogarisë suaj. Përmbledhjet standarde dhe Gmail përmbajnë fushat OTP dhe verification-link; Outlook gjithashtu përfshin from_name, snippet, received_at dhe has_attachments. Sinkronizimi dhe caching-u i ofruesit mund të vonojnë mesazhet e reja dhe numërimet.
Lexo mesazhet e kutisë postare
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"
}
Fushat e përgjigjes
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.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

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ë.

Parametrat 2
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>
Lexo një mesazh
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"
            }
        ]
    }
}
Fushat e përgjigjes
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.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Fshi Mesazhin

Fshij një mesazh të vetëm të pronësuar.

Parametrat 3
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ë.
Fshij një mesazh
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."
}
Fushat e përgjigjes
Fushë Lloj Përshkrimi
status boolean
Nëse operacioni pati sukses.
message string
Rezultati i fshirjes. Një burim i munguar kthen HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Shkarko Bashkëngjitjen

Shkarko një shtojcë nga një mesazh i pronësuar.

Parametrat 3
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>
Suksesi kthen bajtët e skedarit, jo JSON. Skedarët e tepruar kthejnë HTTP 403; skedarët lokalë të munguar ose të padisponueshëm kthejnë HTTP 404. Kodoni URL emrin e skedarit si një segment i vetëm i shtigjes. Vetëm metadata e bashkëngjitjes nuk garanton disponueshmërinë e shkarkimit.
Shkarko një shtojcë
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
Sjellja e shkarkimit Ky pikë e fundit kthen skedarin e kërkuar direkt në vend të një trupi JSON.
Fushat e përgjigjes
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.

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

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).

X-RateLimit-* përshkruan buxhetin e kërkesës së treguar; X-Quota-* përshkruan kapacitetin mujor dhe të blerë kur është i disponueshëm. X-Mailbox-RateLimit-* raporton buxhetin e veçantë për krijimin/azhurnimin e kutisë postare. Një refuzim vetëm për kutinë postare përdor shkallën e kutisë postare dhe dritën e vet të riprovimit. Refuzimet me kufi minutë mund të injorojnë informacionin e kuotës. Retry-After përfshihet vetëm për një riprovim të kohëzuar; qasja e çaktivizuar mund të kërkojë një ndryshim llogarie. Në këtë përgjigje të statusit të suksesshëm, data.limit, data.remaining dhe data.reset përshkruajnë buxhetin në minuta të llogarisë, jo kreditë e shpenzueshme. Objekti data.quota përshkruan lejen mujore, bilancet e krediteve dhe përdorimin. Fushat ekzistuese data.monthly_limit, data.monthly_remaining dhe data.purchased_credits mbeten aliasë të fushave përkatëse të kuotës. Një kontroll i suksesshëm i statusit nuk autorizon një operacion tjetër API. Operacionet ende kërkojnë akses të aktivizuar, kuotë të disponueshme dhe pranueshmëri përmes të gjitha kufijve të aplikueshëm. Pamja e kuotës nuk premton kapacitet që tashmë është rezervuar nga një kërkesë në proces.
Kontrollo statusin e kufirit të normës
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"
        }
    }
}
Fushat e përgjigjes
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.

Mbrojtja me PIN e kutisë postare

Fut PIN-in për të vazhduar. Kutia juaj postare mbetet e shkyçur ndërkohë që është aktuale në këtë sesion të faqes së internetit.

A pranon cookies?

Ne përdorim cookie për të përmirësuar përvojën tuaj të shfletimit. Duke përdorur këtë vend, ju jeni dakord me politikën tonë të cookie-ve.

Më shumë