TempMailg API Dokumentacija

REST API v1 & Webhook-ovi

TempMailg Dokumentacija API-ja za programere

Koristite ovu dokumentaciju da generišete lični API ključ, povežite posvećeni korisnički API host, pročitajte poruke poštanskih sandučića, upravljajte vlasničkim poštanskim sandučićima i integrišite Temp Mail u svoje aplikacije ili automatizacije.

Autentifikacija nosioca tokena Webhooks u realnom vremenu Gmail i Outlook aliasi JSON odgovori
Bazni URL za korisnički API HTTPS
Format zahteva Koristite API ključ samo u zaglavlju Autorizacije Bearer i čuvajte čiste URL-ove krajnjih tačaka.

Upravljanje poštanskim sandučićem

Preuzmite dozvoljene domene, kreirajte ili promenite poštanske sandučiće, izaberite dozvoljena vremena trajanja i obrišite vlasničke adrese.

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

Lista dozvoljenih domena

Izlistajte dostupne domene za kreiranje privremenih e‑mailova. Filtrirajte po tipu da biste videli samo besplatne, premium ili prilagođene domene podržane vašim pretplatničkim planom.

Parametri 1
Parametar Lokacija Tip Status Opis
type query string opcionalno
Filter nivoa domena. Izostavljanje koristi sve kada je omogućen premium-domen pristup, u suprotnom besplatno. Prepoznate vrednosti: free, basic, pro, premium, custom, ultimate, all
Podrazumevano: Zavisi od naloga
Dobijanje dozvoljenih domena
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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
            }
        ]
    }
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
data.requested_type string
Primijenjen filter domena.
data.plan string
Trenutna oznaka plana.
data.plan_name string
Čitljivo ime trenutnog plana.
data.allowed_types array<string>
Filteri domena dostupni za ovaj nalog. Prepoznati filter i dalje može biti zabranjen za vaš plan.
data.domains array
Izabrani domeni nakon filtriranja; prazan niz je validan.
data.domains[].domain string
Izborni naziv domena.
data.domains[].type string
Oznaka nivoa čitljivog domena.
data.domains[].custom boolean
Da li je ovo prilagođeni domen.
POST https://v1.tempmailg.com/api/emails
#

Kreiraj privremeni sandučić

Kreirajte vlasničko privremeno poštansko sanduče. Izostavite korisničko ime i domen za nasumičnu generaciju, ili navedite dozvoljeno prilagođeno korisničko ime i dozvoljeni domen. Parametar provider može izabrati generisanje Gmail ili Outlook aliasa.

Parametri 8
Parametar Lokacija Tip Status Opis
username body string opcionalno
Opcionalno prilagođeno korisničko ime: 2 do 64 ASCII slova, cifre, tačke, donje crte ili crtice. Zahteva dozvolu plana; custom_username je takođe prihvaćen.
Podrazumevano: Nasumično generisano
domain body string opcionalno
Jedan od dozvoljenih domena koji se vraća GET /domains. Izostavljanje bira nasumični dozvoljeni domen.
Podrazumevano: Nasumični dozvoljeni domen
lifetime body string opcionalno
dozvoljene vrednosti:
10m — 10 минута 1h — 1 Сат 2h — 2 сата 1d — 1 дан 1w — 1 Nedelja 1m — 30 дана 3m — 90 дана 6m — 180 дана 1y — 365 дана unlimited — Neograničeno
Podrazumevano: Podrazumevano trajanje plana
provider body string opcionalno
Provajder poštanskog sandučeta: standard, gmail_alias, ili outlook_alias.
Podrazumevano: standard
pin_enabled body boolean opcionalno
Opcionalna PIN zaštita za novo poštansko sanduče, kada je dozvoljena vašim planom. Ne menja PIN postojećeg poštanskog sandučeta.
Podrazumevano: false
pin body string opcionalno
Obavezno kada je pin_enabled true: PIN od 6 do 8 cifara, poslat kao string da bi se sačuvale vodeće nule.
pin_confirmation body string opcionalno
Potrebno kada je pin_enabled postavljen na true. Mora tačno da se podudara sa pin-om.
Idempotency-Key header string opcionalno
Potrebno za kreiranje ili brisanje zaštićeno PIN-om: stabilan ključ od 16 do 128 znakova. Ponovite identičan zahtev sa istim ključem da izbegnete dupliranje posla.
Opcioni parametri tela: username (prilagođeno korisničko ime ako je dozvoljeno planom), domain (dozvoljeni domen, npr. example.com), lifetime (dozvoljene vrednosti: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Izostavite vreme trajanja ili ostavite prazno da biste koristili podrazumevano vreme trajanja e‑maila podešeno za vaš trenutni mesečni/godišnji plan. Pošaljite dozvoljeno vreme trajanja, na primer 1h, da biste prepisali podrazumevano. Neograničeno se koristi samo kada je podešeno kao podrazumevano za plan ili je izričito zatraženo i dozvoljeno. Telo parametara mailbox_lifetime i email_lifetime takođe su prihvaćeni; prva ne-prazna vrednost se uzima u ovom redosledu: lifetime, mailbox_lifetime, email_lifetime. Nevažeće ili nedozvoljene vrednosti vraćaju HTTP 422 umesto da tiho odaberu podrazumevanu vrednost.
Kreiraj poštansko sanduče
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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:17:51+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:17:51+00:00",
        "email_token": "encrypted-email-token"
    }
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
data.id integer
ID poštanskog sandučeta. Generisani ID‑ovi, adrese i tokeni se razlikuju za svako sanduče.
data.pin_protected boolean
Da li ovo poštansko sanduče ima PIN zaštitu. PIN ili hash PIN-a se ne vraća.
data.email string
Generisana puna adresa poštanskog sandučeta.
data.domain string
Domen generisanog poštanskog sandučeta.
data.provider string
Provajder poštanskog sandučeta: standard, gmail_alias, ili outlook_alias.
data.expire_at string|null
Efektivni datum isteka kao ISO-8601 vremenski žig, ili null za neograničeno poštansko sanduče.
data.expires_in_seconds number|null
Ne‑negativni preostali sekundi prilikom izračunavanja; mogući su i decimalni sekundi. Null znači neograničeno, a ne nula.
data.mailbox_state string
Trenutno stanje poštanskog sandučeta: aktivno, pauzirano, isteklo ili neaktivno.
data.receiving_enabled boolean
Da li ovaj poštanski sandučić trenutno prihvata dolazne poruke.
data.message_count integer
Poznat ukupan broj poruka; može odražavati poslednju sinhronizaciju poštanskog sandučeta.
data.unread_message_count integer
Poznat broj nepročitanih poruka; može odražavati poslednju sinhronizaciju pošte.
data.last_message_received_at string|null
Poslednje poznato vreme primljene poruke u ISO-8601 formatu, ili null kada nije dostupno.
data.message_count_synced_at string|null
Vreme poslednje sinhronizacije broja poruka u ISO-8601 formatu, ili null pre sinhronizacije.
data.created_at string|null
Vreme kreiranja poštanskog sandučeta u ISO-8601 formatu.
data.email_token string
Neprozirna šifrovana referenca poštanskog sandučeta. Ne zamenjuje Bearer autentifikaciju, provere vlasništva ili PIN autorizaciju.
data.pin_grant object
Uslovno: aktivno kreiranje poštanskog sandučića zaštićenog PIN-om vraća ovo odobrenje za čitanje; obična neštićena kreacija ga izostavlja.
data.pin_grant.mailbox_id integer
ID poštanskog sandučeta na koji je vezano uslovno odobrenje za čitanje.
data.pin_grant.unlock_token string
Neprozirni token za čitanje za X-Mailbox-Unlock sa istim akreditivom vlasnika. Držite ga privatnim i u memoriji; dozvola za čitanje ne ovlašćuje brisanje.
data.pin_grant.scope string
Opseg pročitan za uslovno odobrenje kreiranja.
data.pin_grant.idle_timeout_seconds integer
Dozvoljeno vreme neaktivnosti za dozvolu čitanja, obično 3600 sekundi.
data.pin_grant.absolute_timeout_seconds integer
Maksimalno trajanje dozvole za čitanje, obično 86400 sekundi.
data.pin_grant.expires_at string
Trenutni rok isteka dozvole za čitanje u ISO-8601 formatu.
data.pin_grant.absolute_expires_at string
Apsolutni datum isteka odobrenja za čitanje u ISO-8601 formatu. Bezbednosne promene mogu ranije opozvati odobrenje.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Ažuriraj / Promeni poštansko sanduče

Kreirajte ili izaberite poštansko sanduče na novom korisničkom imenu i domenu nakon što potvrdite vlasništvo nad trenutnim sandučem. Ovo ne preimenuje staro sanduče niti menja njegov životni vek na licu mesta. Kada se odredište razlikuje, staro sanduče ostaje u istoriji i može biti pauzirano zbog ograničenja aktivnih sandučića. Ponovno korišćenje vašeg sopstvenog aktivnog odredišta ponovo primenjuje njegov traženi životni vek ili podrazumevani plan.

Parametri 9
Parametar Lokacija Tip Status Opis
email path string obavezno
Trenutna puna email adresa vlasničkog poštanskog sandučeta za promenu. URL‑enkodirajte svaki segment puta; enkodirajte znak plus kao %2B.
username path string obavezno
Novi željeni korisničko ime: 2 do 64 alfanumerička karaktera; podložno dozvoli za prilagođeno korisničko ime.
domain path string obavezno
Novo dozvoljeno ime domena.
lifetime body string opcionalno
dozvoljene vrednosti:
10m — 10 минута 1h — 1 Сат 2h — 2 сата 1d — 1 дан 1w — 1 Nedelja 1m — 30 дана 3m — 90 дана 6m — 180 дана 1y — 365 дана unlimited — Neograničeno
Podrazumevano: Podrazumevano trajanje plana
pin_enabled body boolean opcionalno
Opcionalna PIN zaštita za novo poštansko sanduče, kada je dozvoljena vašim planom. Ne menja PIN postojećeg poštanskog sandučeta.
Podrazumevano: false
pin body string opcionalno
Obavezno kada je pin_enabled true: PIN od 6 do 8 cifara, poslat kao string da bi se sačuvale vodeće nule.
pin_confirmation body string opcionalno
Potrebno kada je pin_enabled postavljen na true. Mora tačno da se podudara sa pin-om.
Idempotency-Key header string opcionalno
Potrebno za kreiranje ili brisanje zaštićeno PIN-om: stabilan ključ od 16 do 128 znakova. Ponovite identičan zahtev sa istim ključem da izbegnete dupliranje posla.
X-Mailbox-Unlock header string opcionalno
Zaglavlje, samo za zaštićene poštanske sandučiće: koristite read unlock_token. Prvo pošaljite POST pin i scope=read na PIN unlock URL. Zadržite svoju normalnu Bearer autentifikaciju. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Korišćenje postojeće lične poštanske adrese u {email}. Opcioni parametar u telu: lifetime (dozvoljene vrednosti: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Izostavite vreme trajanja ili ostavite prazno da biste koristili podrazumevano vreme trajanja e‑maila podešeno za vaš trenutni mesečni/godišnji plan. Pošaljite dozvoljeno vreme trajanja, na primer 1h, da biste prepisali podrazumevano. Neograničeno se koristi samo kada je podešeno kao podrazumevano za plan ili je izričito zatraženo i dozvoljeno. Telo parametara mailbox_lifetime i email_lifetime takođe su prihvaćeni; prva ne-prazna vrednost se uzima u ovom redosledu: lifetime, mailbox_lifetime, email_lifetime. Nevažeće ili nedozvoljene vrednosti vraćaju HTTP 422 umesto da tiho odaberu podrazumevanu vrednost.
Ažuriraj lični poštanski sandučić
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'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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:27:51+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:17:51+00:00",
        "email_token": "encrypted-email-token"
    }
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
data.id integer
ID poštanskog sandučeta. Generisani ID‑ovi, adrese i tokeni se razlikuju za svako sanduče.
data.pin_protected boolean
Da li ovo poštansko sanduče ima PIN zaštitu. PIN ili hash PIN-a se ne vraća.
data.email string
Generisana puna adresa poštanskog sandučeta.
data.domain string
Domen generisanog poštanskog sandučeta.
data.provider string
Provajder poštanskog sandučeta: standard, gmail_alias, ili outlook_alias.
data.expire_at string|null
Efektivni datum isteka kao ISO-8601 vremenski žig, ili null za neograničeno poštansko sanduče.
data.expires_in_seconds number|null
Ne‑negativni preostali sekundi prilikom izračunavanja; mogući su i decimalni sekundi. Null znači neograničeno, a ne nula.
data.mailbox_state string
Trenutno stanje poštanskog sandučeta: aktivno, pauzirano, isteklo ili neaktivno.
data.receiving_enabled boolean
Da li ovaj poštanski sandučić trenutno prihvata dolazne poruke.
data.message_count integer
Poznat ukupan broj poruka; može odražavati poslednju sinhronizaciju poštanskog sandučeta.
data.unread_message_count integer
Poznat broj nepročitanih poruka; može odražavati poslednju sinhronizaciju pošte.
data.last_message_received_at string|null
Poslednje poznato vreme primljene poruke u ISO-8601 formatu, ili null kada nije dostupno.
data.message_count_synced_at string|null
Vreme poslednje sinhronizacije broja poruka u ISO-8601 formatu, ili null pre sinhronizacije.
data.created_at string|null
Vreme kreiranja poštanskog sandučeta u ISO-8601 formatu.
data.email_token string
Neprozirna šifrovana referenca poštanskog sandučeta. Ne zamenjuje Bearer autentifikaciju, provere vlasništva ili PIN autorizaciju.
data.pin_grant object
Uslovno: aktivno kreiranje poštanskog sandučića zaštićenog PIN-om vraća ovo odobrenje za čitanje; obična neštićena kreacija ga izostavlja.
data.pin_grant.mailbox_id integer
ID poštanskog sandučeta na koji je vezano uslovno odobrenje za čitanje.
data.pin_grant.unlock_token string
Neprozirni token za čitanje za X-Mailbox-Unlock sa istim akreditivom vlasnika. Držite ga privatnim i u memoriji; dozvola za čitanje ne ovlašćuje brisanje.
data.pin_grant.scope string
Opseg pročitan za uslovno odobrenje kreiranja.
data.pin_grant.idle_timeout_seconds integer
Dozvoljeno vreme neaktivnosti za dozvolu čitanja, obično 3600 sekundi.
data.pin_grant.absolute_timeout_seconds integer
Maksimalno trajanje dozvole za čitanje, obično 86400 sekundi.
data.pin_grant.expires_at string
Trenutni rok isteka dozvole za čitanje u ISO-8601 formatu.
data.pin_grant.absolute_expires_at string
Apsolutni datum isteka odobrenja za čitanje u ISO-8601 formatu. Bezbednosne promene mogu ranije opozvati odobrenje.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Obriši poštansko sanduče

Obrišite posedno poštansko sanduče i pokrenite njegovo čišćenje poruka i fajlova. Zadržani zapisi poštanskog sandučeta mogu biti interno mekano izbrisani; adresa više nije upotrebljiva putem API-ja.

Parametri 3
Parametar Lokacija Tip Status Opis
email path string obavezno
Puna e‑mail adresa vlasničkog poštanskog sandučeta za brisanje. URL‑enkodujte adresu; znak plus enkodujte kao %2B.
X-Mailbox-Unlock header string opcionalno
Zaglavlje, samo za zaštićene poštanske sandučiće: koristite jednokratni token za brisanje unlock_token. Prvo pošaljite POST pin, scope=delete i akciju/target_id koji se vraća u 423 odgovoru na URL za otključavanje PIN-a. Token za čitanje ne može brisati. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opcionalno
Potrebno za kreiranje ili brisanje zaštićeno PIN-om: stabilan ključ od 16 do 128 znakova. Ponovite identičan zahtev sa istim ključem da izbegnete dupliranje posla.
Brisanje ličnog poštanskog sandučića
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
message string
Rezultat brisanja. Nedostajući resurs vraća HTTP 404.

Gmail i Outlook aliasi

Generišite poštanske sandučiće visokog ugleda za Gmail i Outlook/Hotmail alijase.

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

Kreiraj Gmail alias

Kreirajte novo Gmail alias privremeno poštansko sanduče u vlasništvu autentifikovanog korisnika.

Parametri 8
Parametar Lokacija Tip Status Opis
mode body string opcionalno
Režim generisanja: auto, dot, plus ili plus_dot. Takođe prihvata gmail_alias_mode. Ako izbor stila nije dozvoljen, koristi se auto.
Podrazumevano: auto
username body string opcionalno
Opcioni prilagođeni sufiks aliasa: 2 do 32 ASCII slova ili cifre, normalizovano u mala slova; podložno dozvoli funkcije. Takođe prihvata custom_username ili alias_username.
Podrazumevano: Automatski generisano
domain body string opcionalno
Koristite nasumično, gmail.com ili googlemail.com; alias_domain je takođe prihvaćen. Izostavljanje ili nedostupna dozvola za izbor domena koristi nasumično.
Podrazumevano: random
lifetime body string opcionalno
dozvoljene vrednosti:
10m — 10 минута 1h — 1 Сат 2h — 2 сата 1d — 1 дан 1w — 1 Nedelja 1m — 30 дана 3m — 90 дана 6m — 180 дана 1y — 365 дана unlimited — Neograničeno
Podrazumevano: Podrazumevano trajanje plana
pin_enabled body boolean opcionalno
Opcionalna PIN zaštita za novo poštansko sanduče, kada je dozvoljena vašim planom. Ne menja PIN postojećeg poštanskog sandučeta.
Podrazumevano: false
pin body string opcionalno
Obavezno kada je pin_enabled true: PIN od 6 do 8 cifara, poslat kao string da bi se sačuvale vodeće nule.
pin_confirmation body string opcionalno
Potrebno kada je pin_enabled postavljen na true. Mora tačno da se podudara sa pin-om.
Idempotency-Key header string opcionalno
Potrebno za kreiranje ili brisanje zaštićeno PIN-om: stabilan ključ od 16 do 128 znakova. Ponovite identičan zahtev sa istim ključem da izbegnete dupliranje posla.
Zahteva da dozvola Gmail Alias API bude omogućena u vašem pretplatničkom planu ili otključana putem paketa API kredita. Opcioni parametri: mode (auto, dot, plus, plus_dot), username (prilagođeno korisničko ime aliasa), domain (npr. gmail.com, googlemail.com), lifetime (dozvoljene vrednosti: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Izostavite vreme trajanja ili ostavite prazno da biste koristili podrazumevano vreme trajanja e‑maila podešeno za vaš trenutni mesečni/godišnji plan. Pošaljite dozvoljeno vreme trajanja, na primer 1h, da biste prepisali podrazumevano. Neograničeno se koristi samo kada je podešeno kao podrazumevano za plan ili je izričito zatraženo i dozvoljeno. Telo parametara mailbox_lifetime i email_lifetime takođe su prihvaćeni; prva ne-prazna vrednost se uzima u ovom redosledu: lifetime, mailbox_lifetime, email_lifetime. Nevažeće ili nedozvoljene vrednosti vraćaju HTTP 422 umesto da tiho odaberu podrazumevanu vrednost.
Kreiraj Gmail alias sandučić
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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:17:51+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:17:51+00:00",
        "email_token": "encrypted-email-token"
    }
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
data.id integer
ID poštanskog sandučeta. Generisani ID‑ovi, adrese i tokeni se razlikuju za svako sanduče.
data.pin_protected boolean
Da li ovo poštansko sanduče ima PIN zaštitu. PIN ili hash PIN-a se ne vraća.
data.email string
Generisana puna adresa poštanskog sandučeta.
data.domain string
Domen generisanog poštanskog sandučeta.
data.provider string
Provajder poštanskog sandučeta: standard, gmail_alias, ili outlook_alias.
data.expire_at string|null
Efektivni datum isteka kao ISO-8601 vremenski žig, ili null za neograničeno poštansko sanduče.
data.expires_in_seconds number|null
Ne‑negativni preostali sekundi prilikom izračunavanja; mogući su i decimalni sekundi. Null znači neograničeno, a ne nula.
data.mailbox_state string
Trenutno stanje poštanskog sandučeta: aktivno, pauzirano, isteklo ili neaktivno.
data.receiving_enabled boolean
Da li ovaj poštanski sandučić trenutno prihvata dolazne poruke.
data.message_count integer
Poznat ukupan broj poruka; može odražavati poslednju sinhronizaciju poštanskog sandučeta.
data.unread_message_count integer
Poznat broj nepročitanih poruka; može odražavati poslednju sinhronizaciju pošte.
data.last_message_received_at string|null
Poslednje poznato vreme primljene poruke u ISO-8601 formatu, ili null kada nije dostupno.
data.message_count_synced_at string|null
Vreme poslednje sinhronizacije broja poruka u ISO-8601 formatu, ili null pre sinhronizacije.
data.created_at string|null
Vreme kreiranja poštanskog sandučeta u ISO-8601 formatu.
data.email_token string
Neprozirna šifrovana referenca poštanskog sandučeta. Ne zamenjuje Bearer autentifikaciju, provere vlasništva ili PIN autorizaciju.
data.pin_grant object
Uslovno: aktivno kreiranje poštanskog sandučića zaštićenog PIN-om vraća ovo odobrenje za čitanje; obična neštićena kreacija ga izostavlja.
data.pin_grant.mailbox_id integer
ID poštanskog sandučeta na koji je vezano uslovno odobrenje za čitanje.
data.pin_grant.unlock_token string
Neprozirni token za čitanje za X-Mailbox-Unlock sa istim akreditivom vlasnika. Držite ga privatnim i u memoriji; dozvola za čitanje ne ovlašćuje brisanje.
data.pin_grant.scope string
Opseg pročitan za uslovno odobrenje kreiranja.
data.pin_grant.idle_timeout_seconds integer
Dozvoljeno vreme neaktivnosti za dozvolu čitanja, obično 3600 sekundi.
data.pin_grant.absolute_timeout_seconds integer
Maksimalno trajanje dozvole za čitanje, obično 86400 sekundi.
data.pin_grant.expires_at string
Trenutni rok isteka dozvole za čitanje u ISO-8601 formatu.
data.pin_grant.absolute_expires_at string
Apsolutni datum isteka odobrenja za čitanje u ISO-8601 formatu. Bezbednosne promene mogu ranije opozvati odobrenje.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook alias domeni

Preuzmite aktivne Outlook / Hotmail domene aliasa dostupne za generisanje poštanskog sandučeta.

Zahteva da dozvola Outlook Alias API bude omogućena na vašem pretplatničkom planu ili otključana putem paketa API kredita. Ukazuje da li je odabir određenog domena otključan u vašem planu.
Preuzmi Outlook alias domene
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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
            }
        ]
    }
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
data.domains array
Aktivni Outlook/Hotmail domeni; prazan niz je validan.
data.domains[].domain string
Dostupan naziv domena.
data.domains[].type string
Čitljiva oznaka provajdera.
data.domains[].selectable boolean
Da li vaš nalog može eksplicitno izabrati ovaj domen.
data.domains[].locked boolean
Da li je eksplicitni izbor domena zaključan za vaš nalog.
data.domains[].disabled_reason string|null
Razlog zašto je izbor domena zaključan, ili null kada je moguće izabrati.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Kreiraj Outlook alias

Kreirajte novi Outlook / Hotmail alias privremenu poštansku kutiju u vlasništvu autentifikovanog korisnika.

Parametri 7
Parametar Lokacija Tip Status Opis
domain body string opcionalno
Koristite nasumičan ili domen iz GET /outlook-alias/domains; outlook_alias_domain je takođe prihvaćen. Bez dozvole za izbor, koristi se nasumičan.
Podrazumevano: Nasumični dostupni domen
username body string opcionalno
Opcioni prilagođeni sufiks aliasa: 2 do 32 ASCII slova ili cifre, normalizovano u mala slova; podložno dozvoli funkcije. Takođe prihvata custom_username ili alias_username.
Podrazumevano: Automatski generisano
lifetime body string opcionalno
dozvoljene vrednosti:
10m — 10 минута 1h — 1 Сат 2h — 2 сата 1d — 1 дан 1w — 1 Nedelja 1m — 30 дана 3m — 90 дана 6m — 180 дана 1y — 365 дана unlimited — Neograničeno
Podrazumevano: Podrazumevano trajanje plana
pin_enabled body boolean opcionalno
Opcionalna PIN zaštita za novo poštansko sanduče, kada je dozvoljena vašim planom. Ne menja PIN postojećeg poštanskog sandučeta.
Podrazumevano: false
pin body string opcionalno
Obavezno kada je pin_enabled true: PIN od 6 do 8 cifara, poslat kao string da bi se sačuvale vodeće nule.
pin_confirmation body string opcionalno
Potrebno kada je pin_enabled postavljen na true. Mora tačno da se podudara sa pin-om.
Idempotency-Key header string opcionalno
Potrebno za kreiranje ili brisanje zaštićeno PIN-om: stabilan ključ od 16 do 128 znakova. Ponovite identičan zahtev sa istim ključem da izbegnete dupliranje posla.
Zahteva da dozvola Outlook Alias API bude omogućena na vašem pretplatničkom planu ili otključana putem paketa API kredita. Opcioni parametri: domain (npr. outlook.com, hotmail.com), username (prilagođeno korisničko ime aliasa), lifetime (dozvoljene vrednosti: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Izostavite vreme trajanja ili ostavite prazno da biste koristili podrazumevano vreme trajanja e‑maila podešeno za vaš trenutni mesečni/godišnji plan. Pošaljite dozvoljeno vreme trajanja, na primer 1h, da biste prepisali podrazumevano. Neograničeno se koristi samo kada je podešeno kao podrazumevano za plan ili je izričito zatraženo i dozvoljeno. Telo parametara mailbox_lifetime i email_lifetime takođe su prihvaćeni; prva ne-prazna vrednost se uzima u ovom redosledu: lifetime, mailbox_lifetime, email_lifetime. Nevažeće ili nedozvoljene vrednosti vraćaju HTTP 422 umesto da tiho odaberu podrazumevanu vrednost.
Kreiraj Outlook alias poštansko sanduče
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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:17:51+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:17:51+00:00",
        "email_token": "encrypted-email-token"
    }
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
data.id integer
ID poštanskog sandučeta. Generisani ID‑ovi, adrese i tokeni se razlikuju za svako sanduče.
data.pin_protected boolean
Da li ovo poštansko sanduče ima PIN zaštitu. PIN ili hash PIN-a se ne vraća.
data.email string
Generisana puna adresa poštanskog sandučeta.
data.domain string
Domen generisanog poštanskog sandučeta.
data.provider string
Provajder poštanskog sandučeta: standard, gmail_alias, ili outlook_alias.
data.expire_at string|null
Efektivni datum isteka kao ISO-8601 vremenski žig, ili null za neograničeno poštansko sanduče.
data.expires_in_seconds number|null
Ne‑negativni preostali sekundi prilikom izračunavanja; mogući su i decimalni sekundi. Null znači neograničeno, a ne nula.
data.mailbox_state string
Trenutno stanje poštanskog sandučeta: aktivno, pauzirano, isteklo ili neaktivno.
data.receiving_enabled boolean
Da li ovaj poštanski sandučić trenutno prihvata dolazne poruke.
data.message_count integer
Poznat ukupan broj poruka; može odražavati poslednju sinhronizaciju poštanskog sandučeta.
data.unread_message_count integer
Poznat broj nepročitanih poruka; može odražavati poslednju sinhronizaciju pošte.
data.last_message_received_at string|null
Poslednje poznato vreme primljene poruke u ISO-8601 formatu, ili null kada nije dostupno.
data.message_count_synced_at string|null
Vreme poslednje sinhronizacije broja poruka u ISO-8601 formatu, ili null pre sinhronizacije.
data.created_at string|null
Vreme kreiranja poštanskog sandučeta u ISO-8601 formatu.
data.email_token string
Neprozirna šifrovana referenca poštanskog sandučeta. Ne zamenjuje Bearer autentifikaciju, provere vlasništva ili PIN autorizaciju.
data.pin_grant object
Uslovno: aktivno kreiranje poštanskog sandučića zaštićenog PIN-om vraća ovo odobrenje za čitanje; obična neštićena kreacija ga izostavlja.
data.pin_grant.mailbox_id integer
ID poštanskog sandučeta na koji je vezano uslovno odobrenje za čitanje.
data.pin_grant.unlock_token string
Neprozirni token za čitanje za X-Mailbox-Unlock sa istim akreditivom vlasnika. Držite ga privatnim i u memoriji; dozvola za čitanje ne ovlašćuje brisanje.
data.pin_grant.scope string
Opseg pročitan za uslovno odobrenje kreiranja.
data.pin_grant.idle_timeout_seconds integer
Dozvoljeno vreme neaktivnosti za dozvolu čitanja, obično 3600 sekundi.
data.pin_grant.absolute_timeout_seconds integer
Maksimalno trajanje dozvole za čitanje, obično 86400 sekundi.
data.pin_grant.expires_at string
Trenutni rok isteka dozvole za čitanje u ISO-8601 formatu.
data.pin_grant.absolute_expires_at string
Apsolutni datum isteka odobrenja za čitanje u ISO-8601 formatu. Bezbednosne promene mogu ranije opozvati odobrenje.

Poruke & Prilozi

Preuzmite dolazne sandučiće, pročitajte pune HTML/tekst poruke i strimujte priloge.

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

Lista poruka poštanskog sandučeta

Preuzmite dostupne sažetke poruka i metapodatke poštanskog sandučeta. Standardna skeniranja pristigle pošte vraćaju najnoviji skup do 25 poruka; ovo nije paginirani endpoint za kompletnu istoriju. Koristite GET /messages/{messageId} za potpune sadržaje i priloge.

Parametri 2
Parametar Lokacija Tip Status Opis
email query string obavezno
Puna adresa e‑mail pošte u vlasništvu iz koje se čitaju poruke. URL‑enkodirajte vrednost upita; enkodirajte znak plus kao %2B.
X-Mailbox-Unlock header string opcionalno
Zaglavlje, samo za zaštićene poštanske sandučiće: koristite read unlock_token. Prvo pošaljite POST pin i scope=read na PIN unlock URL. Zadržite svoju normalnu Bearer autentifikaciju. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
E‑mail mora pripadati vašem nalogu. Standardni i Gmail rezimei sadrže OTP i verification-link polja; Outlook takođe uključuje from_name, snippet, received_at i has_attachments. Sinhronizacija provajdera i keširanje mogu odložiti nove poruke i brojeve.
Čitanje poruka poštanskog sandučića
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'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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:17:51",
            "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:17:51+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:17:51+00:00",
    "message_count_synced_at": "2026-11-19T02:17:51+00:00"
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
mailbox string
Adresa poštanskog sandučeta čije su poruke zatražene.
email_token string
Neprozirna šifrovana referenca poštanskog sandučeta; i dalje je potrebna normalna autentifikacija.
mailbox_provider string
Provajder poštanskog sandučeta: standard, gmail_alias, ili outlook_alias.
messages array
Sažeci poruka. Prazan sandučić vraća prazan niz; preuzmite pojedinačnu poruku za njeno telo i priloge.
expire_at string|null
Efektivni datum isteka kao ISO-8601 vremenski žig, ili null za neograničeno poštansko sanduče.
expires_in_seconds number|null
Ne‑negativni preostali sekundi prilikom izračunavanja; mogući su i decimalni sekundi. Null znači neograničeno, a ne nula.
mailbox_state string
Trenutno stanje poštanskog sandučeta: aktivno, pauzirano, isteklo ili neaktivno.
receiving_enabled boolean
Da li ovaj poštanski sandučić trenutno prihvata dolazne poruke.
message_count integer
Poznat ukupan broj poruka; može odražavati poslednju sinhronizaciju poštanskog sandučeta.
unread_message_count integer
Poznat broj nepročitanih poruka; može odražavati poslednju sinhronizaciju pošte.
last_message_received_at string|null
Poslednje poznato vreme primljene poruke u ISO-8601 formatu, ili null kada nije dostupno.
message_count_synced_at string|null
Vreme poslednje sinhronizacije broja poruka u ISO-8601 formatu, ili null pre sinhronizacije.
mailbox_limit.limit integer
Aktivni limit poštanskog sandučeta za ovog provajdera; -1 znači neograničeno.
mailbox_limit.limit_label string
Prikazni naziv za ograničenje poštanskog sandučeta.
mailbox_limit.active_count integer
Broj aktivnih poštanskih sandučića za ovog provajdera.
mailbox_limit.paused_count integer
Broj pauziranih poštanskih sandučića za ovog provajdera.
mailbox_limit.paused_mailboxes array<string>
Adrese su pauzirane zbog ograničenja poštanskog sandučeta.
mailbox_limit.remaining integer
Preostali aktivni slotovi poštanskog sandučeta; -1 znači neograničeno. Ovo nije kvota API zahteva.
mailbox_limit.remaining_label string
Prikaz oznake za preostale slotove poštanskog sandučeta.
mailbox_limit.reached boolean
Da li je dostignut limit aktivnih poštanskih sandučića.
mailbox_limit.blocked boolean
Da li je aktivni limit poštanskog sandučeta nula.
mailbox_limit.provider string|null
Provajder na koji se odnosi limit poštanskog sandučeta.
messages[].id string
Neprozirni ID poruke koji koriste krajnje tačke za pojedinačnu poruku, brisanje i prilog.
messages[].is_seen boolean
Da li je poruka označena kao pročitana.
messages[].subject string
Naslov poruke.
messages[].from string
Prikazano ime pošiljaoca ili adresa.
messages[].from_email string
Adresa e‑mail pošiljaoca.
messages[].receivedAt string
Vreme prijema u vremenskoj zoni aplikacije, formatirano kao YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Detektovan jednokratni kod kada je dostupan i dozvoljen; u suprotnom null.
messages[].otp_locked boolean
Da li je otkriveni jednokratni kod sakriven dozvolama funkcije.
messages[].verification_link string|null
Otkriven URL za verifikaciju kada je dostupan i dozvoljen; u suprotnom null.
messages[].verification_link_locked boolean
Da li je otkriveni verifikacioni link sakriven dozvolama funkcije.
messages[].from_name string|null
Outlook polje sažetka: ime originalnog pošiljaoca. Nedostaje u Standardnim i Gmail sažecima.
messages[].snippet string|null
Outlook polje sažetka: kratak pregled poruke.
messages[].received_at string|null
Outlook polje sažetka: ISO-8601 vreme prijema, kada je poznato.
messages[].has_attachments boolean
Outlook polje sažetka: da li postoje metapodaci priloga. Dostupnost preuzimanja se proverava odvojeno.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Preuzmi pojedinačnu poruku

Preuzmite posednu poruku po njenom neprozirnom ID‑u poruke. Vraća formate tela i metapodatke priloga. Polja tela zavise od formata poruke; Outlook dodaje specifična polja provajdera navedena ispod.

Parametri 2
Parametar Lokacija Tip Status Opis
messageId path string obavezno
Jedinstveni ID poruke vraćen u listi poruka.
X-Mailbox-Unlock header string opcionalno
Zaglavlje, samo za zaštićene poštanske sandučiće: koristite read unlock_token. Prvo pošaljite POST pin i scope=read na PIN unlock URL. Zadržite svoju normalnu Bearer autentifikaciju. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Čitanje jedne poruke
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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:17:51",
        "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"
            }
        ]
    }
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
data.id string
Neprozirni ID poruke.
data.is_seen boolean
Stanje čitanja poruke. Čitanje može označiti da je viđena; keširani podaci mogu odražavati ranije stanje.
data.subject string
Naslov poruke.
data.from string
Prikazano ime pošiljaoca ili adresa.
data.from_email string
Adresa e‑mail pošiljaoca.
data.to string
Adresa poštanskog sandučeta primaoca.
data.mailbox_provider string
Provajder poštanskog sandučeta: standard, gmail_alias, ili outlook_alias.
data.receivedAt string
Vreme prijema u vremenskoj zoni aplikacije, formatirano kao YYYY-MM-DD HH:mm:ss.
data.html boolean
Da li poruka ima HTML telo.
data.html_content string
HTML telo kada je prisutno. Standardne poruke bez HTML-a mogu izostaviti ovo polje. Smatrajte sadržaj poruke nepouzdanim.
data.text_content string
Tekstualno telo kada je prisutno; Standardne poruke mogu sadržati escapovani tekst u pre elementu ili izostaviti ovo polje.
data.content string
Preferirano telo za prikaz, obično HTML kada je dostupno.
data.attachments array
Metapodaci priloga, ili prazan niz. Preuzimanja zahtevaju normalnu autentifikaciju i odgovarajuću PIN autorizaciju.
data.attachments[].name string
Ime datoteke za URL‑kodiranje kao jedan segment puta prilikom preuzimanja.
data.attachments[].size integer
Veličina priloga u bajtovima.
data.attachments[].url string
URL za preuzimanje API-ja autentifikovanog korisnika dodat je uz priloge sa imenom fajla. URL ne garantuje da je lokalni fajl dostupan.
data.attachments[].extension string
Standardno/Gmail polje metapodataka: ekstenzija fajla kada je navedena.
data.attachments[].id string
Outlook metapodatak: ID priloga provajdera.
data.attachments[].content_type string
Outlook metadata polje: MIME tip sadržaja.
data.from_name string|null
Outlook detaljno polje: ime originalnog pošiljaoca.
data.to_email string|null
Outlook detaljno polje: originalna adresa primaoca.
data.received_at string|null
Outlook detaljno polje: ISO-8601 vreme primanja.
data.has_html boolean
Outlook detaljno polje: da li postoji HTML telo.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Obriši poruku

Brisanje jedne lične poruke

Parametri 3
Parametar Lokacija Tip Status Opis
messageId path string obavezno
Jedinstveni ID poruke za trajno brisanje.
X-Mailbox-Unlock header string opcionalno
Zaglavlje, samo za zaštićene poštanske sandučiće: koristite jednokratni token za brisanje unlock_token. Prvo pošaljite POST pin, scope=delete i akciju/target_id koji se vraća u 423 odgovoru na URL za otključavanje PIN-a. Token za čitanje ne može brisati. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string opcionalno
Potrebno za kreiranje ili brisanje zaštićeno PIN-om: stabilan ključ od 16 do 128 znakova. Ponovite identičan zahtev sa istim ključem da izbegnete dupliranje posla.
Obriši jednu poruku
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Polja odgovora
Polje Tip Opis
status boolean
Da li je operacija uspela.
message string
Rezultat brisanja. Nedostajući resurs vraća HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Preuzmi prilog

Preuzmi prilog iz poruke u vlasništvu.

Parametri 3
Parametar Lokacija Tip Status Opis
messageId path string obavezno
ИД поруке која садржи датотеку.
filename path string obavezno
Ime datoteke i ekstenzija priloga za preuzimanje.
X-Mailbox-Unlock header string opcionalno
Zaglavlje, samo za zaštićene poštanske sandučiće: koristite read unlock_token. Prvo pošaljite POST pin i scope=read na PIN unlock URL. Zadržite svoju normalnu Bearer autentifikaciju. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Uspeh vraća bajtove fajla, a ne JSON. Preveliki fajlovi vraćaju HTTP 403; nedostajući ili nedostupni lokalni fajlovi vraćaju HTTP 404. URL‑enkodirajte ime fajla kao jedan segment puta. Samo metapodaci priloga ne garantuju dostupnost preuzimanja.
Preuzmi prilog
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
Ponašanje preuzimanja Ovaj endpoint vraća zahtevanu datoteku direktno umesto JSON tela.
Polja odgovora
Polje Tip Opis
Content-Disposition header
Uspešan odgovor preuzima traženi naziv fajla.
body binary
Bajti fajla pri uspehu, ne JSON. Greške vraćaju JSON sa statusom koji nije 2xx.

Ограничења брзине и квоте

Pratite budžete zahteva u realnom vremenu, ograničenja brzine i kvote naloga bez trošenja kredita.

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

Ograničenje brzine i kvota

Proverite svoj trenutni limit brzine i status kvote bez potrošnje bilo kakve upotrebe API-ja. Ovaj endpoint je bez kvote i ne oduzima mesečne API kredite (ograničenje zaštite od zloupotrebe: 60 zahteva/min).

X-RateLimit-* opisuje naznačeni budžet zahteva; X-Quota-* opisuje mesečni i kupljeni kapacitet kada je dostupan. X-Mailbox-RateLimit-* izveštava o zasebnom budžetu za kreiranje/azuriranje poštanskog sandučeta. Odbijanje samo za poštansko sanduče koristi opseg sandučeta i svoj prozor za ponovni pokušaj. Odbijanja po minutnom limitu mogu izostaviti informacije o kvoti. Retry-After je uključen samo za vremenski ograničen ponovni pokušaj; onemogućen pristup može zahtevati promenu naloga. U ovom uspešnom odgovoru statusa, data.limit, data.remaining i data.reset opisuju budžet po minuti naloga, a ne potrošive kredite. Objekat data.quota opisuje mesečnu dodelu, stanje kredita i potrošnju. Postojeća polja data.monthly_limit, data.monthly_remaining i data.purchased_credits ostaju aliasi odgovarajućih polja kvote. Uspešna provera statusa ne ovlašćuje drugu API operaciju. Operacije i dalje zahtevaju omogućeni pristup, dostupnu kvotu i odobrenje kroz sva primenljiva ograničenja. Snimak kvote ne garantuje kapacitet koji je već rezervisan od strane zahteva u toku.
Proveri status ograničenja zahteva
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Ilustrativni odgovor koristeći sintetičke podatke. ID‑ovi, adrese, tokeni, vremenski žigovi, ograničenja i brojevi plana variraju. Primeri trajanja ne prepisuju podrazumevane vrednosti vašeg plana. Opisi polja odgovora identifikuju nullable i specifična polja provajdera.

Primer odgovora
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"
        }
    }
}
Polja odgovora
Polje Tip Opis
data.limit integer|string
Ograničenje zahteva po minuti za nalog. Niska unlimited označava neograničen minutni budžet; ovo je nezavisno od mesečne kvote.
data.remaining integer|string
Preostali minutni budžet slotovi naloga, ili string „unlimited“. Pozitivna vrednost ne znači da API krediti preostaju.
data.reset integer
Sekunde za minutni prozor naloga, a ne za reset mesečnog kvota. Onemogućeni ili neograničeni minutni budžeti mogu zadržati nominalnu vrednost od 60 sekundi; ovo ne garantuje pristup nakon čekanja.
data.plan string
Trenutna oznaka plana. Čitljivo ime plana je navedeno odvojeno u data.quota.plan_name.
data.quota.enabled boolean
Da li je omogućena globalna i plan/kredit API pristup. Ovo ne ukazuje na preostali kapacitet niti zamenjuje prekidač API-ja za korisnika.
data.quota.user_api_status boolean
Da li je korisnik omogućio svoj prekidač User API. Operacije zahtevaju ovaj prekidač, kao i omogućeni pristup i dostupni kapacitet.
data.quota.plan_name string
Čitljivo ime trenutnog plana.
data.quota.period string
Period korišćenja po kalendarskom mesecu u formatu YYYY-MM, koristeći vremensku zonu aplikacije; ne mora nužno biti period naplate pretplate.
data.quota.base_limit integer
Основно месечно дозвољено у оквиру плана. Вредност -1 значи неограничено.
data.quota.extra_requests integer
Dodatni mesečni dodatak odobren za trenutni period korišćenja; odvojen od kupljenih kredita.
data.quota.monthly_limit integer
Osnovna kvota plus dodatni zahtevi za tekući period. Vrednost -1 znači neograničeno. Kupljeni krediti nisu uključeni.
data.quota.monthly_remaining integer|null
Preostali konačni mesečni iznos, ili null kada je mesečni kvota neograničena. Null se ne sme tumačiti kao nula.
data.quota.used integer
Uspešne, izbrojane API operacije u trenutnom periodu korišćenja, uključujući operacije koje koriste kredite. Provere statusa ne povećavaju ovu vrednost.
data.quota.purchased_credits integer
Trenutno stanje kredita, uključujući bonuse iz aktivnog plana. Bonus krediti ne smeju biti dodati ovom stanju drugi put.
data.quota.bonus_credits integer
Aktivni deo bonusa plana u balansu kredita; razlaganje purchased_credits, a ne dodatni kapacitet.
data.quota.direct_purchased_credits integer
Stanje kredita isključujući deo aktivnog plana-bonusa. Ova vrednost plus bonus_credits jednaka je purchased_credits.
data.quota.remaining integer|null
Mesečni preostali dozvoljeni iznos plus trenutni kreditni saldo, bez dvostrukog brojanja bonusa. Null znači neograničen mesečni kvota. Individualna dozvola za funkcije i ostala ograničenja zahteva i dalje važe.
data.quota.unlimited boolean
Da li je mesečna kvota neograničena. Ovo ne čini minutni budžet naloga ili druge limite funkcija neograničenim.
data.quota.usage_percent integer
Zaokruženi procenat kompatibilan sa kontrolnom tablom od 0 do 100: iskorišćeno podeljeno sa iskorišćeno plus preostalo, pomnoženo sa 100. Uključuje raspoloživi kreditni kapacitet, tako da dopunjavanje može smanjiti procenat. Jednako je 0 za neograničenu kvotu ili bazen nulte veličine; nije to procenat ograničenja po minuti niti odluka o pristupu.
data.quota.reset_at string
ISO-8601 vremenski žig sa pomakom vremenske zone za sledeće resetovanje kvote za kalendarski mesec. Ovo nije datum isteka pretplate, a mesečno resetovanje ne dopunjava kupljene kredite.
status string
Doslovni uspeh za ovaj statusni endpoint. Ostali uspešni endpointi poštanskih sandučića koriste boolean true.
data.monthly_limit integer
Kompatibilni alias odgovarajućeg polja data.quota; ne dodajte ga ponovo prilikom izračunavanja salda.
data.monthly_remaining integer|null
Kompatibilni alias odgovarajućeg polja data.quota; ne dodajte ga ponovo prilikom izračunavanja salda.
data.purchased_credits integer
Kompatibilni alias odgovarajućeg polja data.quota; ne dodajte ga ponovo prilikom izračunavanja salda.

Zaštita PIN-a poštanskog sandučeta

Unesite PIN da nastavite. Vaš poštanski sandučić ostaje otključan dok je aktivan u ovoj sesiji web stranice.

Da li prihvatate kolačiće?

Koristimo kolačiće kako bismo poboljšali vaše iskustvo pretraživanja. Korišćenjem ovog sajta, pristajete na našu politiku kolačića.

Više