Brza lista podešavanja
- Otvorite stranici API Upravljanja na vašem dashboard-u i kreirajte lični API ključ.
- Kopirajte tačan URL baze korisničkog API-a koji je prikazan tamo, na primer https://v1.tempmailg.com/api.
- Pošaljite svaki zahtev na taj API host sa Authorization: Bearer YOUR_USER_API_KEY i Accept: application/json.
- Pratite svoj mesečni kvotu zahteva sa iste stranice kontrolne table i iz zaglavlja kvote kada su dostupna u odgovorima API-ja korisnika. Samo uspešni zahtevi sa statusom 2xx se računaju u kvotu.
Pristup API ključu
Prijavite se da biste kreirali lični API ključ i pregledali detalje žive kvote.
Tok autentifikacije
- Generišite svoj lični API ključ sa dashboard API Management stranice.
- Pošaljite ključ kao Bearer token u svakom zahtevu.
- Koristite posvećeni User API Base URL koji je prikazan na vašoj API Management stranici.
- Regenerišite ključ svaki put kada želite da poništite stari i počnete koristiti novi ključ odmah.
Zaglavlja koja su obavezna
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Zaglavlja ograničenja brzine i kvote
Zaglavlja ograničenja brzine opisuju naznačeni budžet zahteva. Zaglavlja kvote su uključena kada su informacije o kvoti dostupne; odbijanja po minutnom ograničenju ne izračunavaju vašu punu mesečnu kvotu.
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1729520000
X-Quota-Limit: 50000
X-Quota-Remaining: 48210
X-Quota-Used: 1790
X-Quota-Reset: 2026-11-01T00:00:00+00:00
X-RateLimit-Scope: account
Retry-After: 42 (when a timed retry is available)
X-RateLimit-Limit— Maksimalan broj zahteva dozvoljenih po minutu (RPM) za vaš plan.X-RateLimit-Remaining— RPM zahteva preostalo u trenutnom minutnom prozoru.X-RateLimit-Reset— Unix vremenski žig kada se resetuje trenutni prozor ograničenja brzine po minuti.X-Quota-Limit— Ukupni mesečni i kupljeni kreditni kapacitet za vaš nalog.X-Quota-Remaining— Preostali dostupni API zahtevi u tekućem mesecu.X-Quota-Used— Ukupno API zahteva potrošeno u trenutnom obračunskom periodu.X-Quota-Reset— ISO‑8601 vremenski žig kada se resetuje vaša mesečna kvota.X-RateLimit-Scope— Budžet opisan zaglavljima: account, ip, status_endpoint, ili mailbox.X-Mailbox-RateLimit-*— Odvojeni budžet za kreiranje/ažuriranje poštanskog sandučeta. Uspešni odgovori poštanskog sandučeta zadržavaju RPM naloga u X-RateLimit-*; odbijanje samo za poštansko sanduče koristi opseg poštanskog sandučeta i svoj prozor za ponovni pokušaj.Retry-After— Sekundi do kada je prikladno izvršiti vremenski ponovni pokušaj. Onemogućeni plan ili iscrpljena kvota mogu zahtevati promenu naloga, pa ovo zaglavlje nije uvek prisutno.503 protection_unavailable— Skladište ili koordinacija zaštite API-ja je privremeno nedostupna. Pokušajte ponovo kasnije; ovo nije neuspeh plaćanja niti terećenje kredita.
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.
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.
| 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
|
const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/domains?type=free' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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
}
]
}
}
| 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. |
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.
| 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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/emails' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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"
}
}
| 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. |
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.
| 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>
|
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.const response = await fetch('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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"
}
}
| 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. |
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.
| 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.
|
const response = await fetch('https://v1.tempmailg.com/api/emails/demo123@example.com', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/emails/demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request DELETE \
--url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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."
}
| 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.
Kreiraj Gmail alias
Kreirajte novo Gmail alias privremeno poštansko sanduče u vlasništvu autentifikovanog korisnika.
| 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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/gmail-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/gmail-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/gmail-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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"
}
}
| 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. |
Outlook alias domeni
Preuzmite aktivne Outlook / Hotmail domene aliasa dostupne za generisanje poštanskog sandučeta.
const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/domains', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/outlook-alias/domains', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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
}
]
}
}
| 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. |
Kreiraj Outlook alias
Kreirajte novi Outlook / Hotmail alias privremenu poštansku kutiju u vlasništvu autentifikovanog korisnika.
| 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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/outlook-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request POST \
--url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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"
}
}
| 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.
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.
| 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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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"
}
| 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. |
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.
| 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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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"
}
]
}
}
| 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. |
Obriši poruku
Brisanje jedne lične poruke
| 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.
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request DELETE \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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."
}
| Polje | Tip | Opis |
|---|---|---|
status |
boolean | Da li je operacija uspela. |
message |
string | Rezultat brisanja. Nedostajući resurs vraća HTTP 404. |
Preuzmi prilog
Preuzmi prilog iz poruke u vlasništvu.
| 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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()
with open('file.txt', 'wb') as handle:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
handle.write(chunk)
<?php
$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_FILE => $fileHandle,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
if (curl_exec($ch) === false) {
fclose($fileHandle);
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
fclose($fileHandle);
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY' \
--output file.txt
| 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.
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).
const response = await fetch('https://v1.tempmailg.com/api/rate-limit', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/rate-limit', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/rate-limit');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/rate-limit' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
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"
}
}
}
| 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. |
Webhookovi za poštanski sandučak (Realno push-poručivanje)
Уместо редовног полазиња REST API-а (GET /messages) да проверавате доспеле е-поште, конфигуришите вебхукове да у реалном времену шаљу нове поруке на ваш сервер или аутоматизовани ток у радном процесу.
Podržani događaji webhook-a
Сваки вебхук може да се претплати на један или више типова догађаја. Ваш ендпоинт добија обавештење о догађају када се један од ових тригера активира.
Poslato u realnom vremenu kad god nova poruka stigne u izabrano poštansko sanduče.
Šalje se kada privremeni sandučić istekne i obrada webhook‑a je pauzirana.
Šalje se kada istekla poštanska sandučić ponovo postane aktivna prema pravilima plana.
Poslato neposredno pre nego što se webhook i njegovo poštansko sanduče obrišu.
Захтеви за главу & Проверка потписa HMAC
Свака доставка вебхука садржи посебне сигурносне заглавље. Искористите заглавље **X-TempMailg-Signature** да потврдите да су дошли захтеви стварно послани од стране TempMailg и да нису били мењани.
| Наслов | Пример вредност | Opis |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Standardni identifikator za radnika isporuke webhook-a. |
X-TempMailg-Event |
email.received | Tip događaja koji je pokrenuo ovu isporuku. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Jedinstveni UUID dodeljen ovom pokušaju isporuke. |
X-TempMailg-Timestamp |
1725192000 | Unix epoch vremenski žig koji označava kada je zahtev pokrenut. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | HMAC-SHA256 potpis izračunat na osnovu {timestamp}.{raw_body} koristeći vaš tajni ključ. |
X-TempMailg-Test |
false | Tačno kada je poslato putem funkcije "Send Test Ping" na vašoj kontrolnoj tabli. |
Потпис се рачуна користећи HMAC са SHA256 преко следећег низа:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Primjer payloada događaja (email.received)
Slano kao `application/json` u tijelu HTTP POST zahtjeva.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:17:51+00:00",
"test": false,
"mailbox": {
"id": 1024,
"email": "developer@v1.tempmailg.com"
},
"data": {
"message_id": "7a8b9c0d1e2f",
"subject": "Your Verification Code: 948201",
"from": "auth@service.com",
"to": "developer@v1.tempmailg.com",
"date": "2026-11-19T02:17:51+00:00",
"attachments_count": 0,
"text_preview": "Hello, your one-time verification code is 948201. It will expire in 10 minutes.",
"email_url": "https://tempmailg.com/mailbox/1024?message=7a8b9c0d1e2f",
"inbox_url": "https://tempmailg.com/mailbox/1024"
}
}
Primeri implementacije primaoca
Izaberite svoj jezik da biste videli kako da primate webhook-ove i bezbedno verifikujete HMAC potpise.
const express = require('express');
const crypto = require('crypto');
const app = express();
const WEBHOOK_SECRET = 'your_webhook_signing_secret';
// Capture raw body buffer for HMAC-SHA256 signature verification
app.use(express.json({
verify: (req, res, buf) => {
req.rawBody = buf.toString('utf8');
}
}));
app.post('/webhook', (req, res) => {
const timestamp = req.headers['x-tempmailg-timestamp'];
const signatureHeader = req.headers['x-tempmailg-signature'] || '';
// Calculate HMAC-SHA256 signature
const expectedSignature = 'sha256=' + crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(`${timestamp}.${req.rawBody}`)
.digest('hex');
// Verify signature
if (signatureHeader !== expectedSignature) {
return res.status(401).json({ error: 'Invalid webhook signature' });
}
const { event, mailbox, data } = req.body;
console.log(`[Event: ${event}] Mailbox: ${mailbox.email}`);
if (event === 'email.received') {
console.log(`From: ${data.from}`);
console.log(`Subject: ${data.subject}`);
console.log(`Preview: ${data.text_preview}`);
}
// Acknowledge receipt with HTTP 200
res.status(200).json({ received: true });
});
app.listen(3000, () => console.log('Webhook receiver running on port 3000'));
from flask import Flask, request, jsonify
import hmac
import hashlib
app = Flask(__name__)
WEBHOOK_SECRET = b"your_webhook_signing_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
timestamp = request.headers.get("X-TempMailg-Timestamp", "")
signature_header = request.headers.get("X-TempMailg-Signature", "")
# Calculate expected HMAC-SHA256 signature
raw_body = request.get_data()
signed_payload = f"{timestamp}.".encode("utf-8") + raw_body
expected_signature = "sha256=" + hmac.new(
WEBHOOK_SECRET, signed_payload, hashlib.sha256
).hexdigest()
# Verify signature securely
if not hmac.compare_digest(signature_header, expected_signature):
return jsonify({"error": "Invalid signature"}), 401
payload = request.get_json()
event = payload.get("event")
mailbox = payload.get("mailbox", {}).get("email")
data = payload.get("data", {})
print(f"[{event}] Mailbox: {mailbox}")
if event == "email.received":
print(f"From: {data.get('from')}")
print(f"Subject: {data.get('subject')}")
print(f"Preview: {data.get('text_preview')}")
# Return 200 OK to acknowledge receipt
return jsonify({"received": True}), 200
if __name__ == "__main__":
app.run(port=5000)
<?php
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_TEMPMAILG_TIMESTAMP'] ?? '';
$receivedSignature = $_SERVER['HTTP_X_TEMPMAILG_SIGNATURE'] ?? '';
// Calculate HMAC-SHA256 signature
$expectedSignature = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
// Verify signature
if (!hash_equals($expectedSignature, $receivedSignature)) {
http_response_code(401);
echo json_encode(['error' => 'Invalid signature']);
exit;
}
$payload = json_decode($rawBody, true);
$event = $payload['event'] ?? '';
$mailbox = $payload['mailbox']['email'] ?? '';
$data = $payload['data'] ?? [];
if ($event === 'email.received') {
$sender = $data['from'] ?? '';
$subject = $data['subject'] ?? '';
$preview = $data['text_preview'] ?? '';
// Process new incoming email...
}
// Acknowledge receipt
http_response_code(200);
echo json_encode(['received' => true]);
Podržane platforme i integracije automatizacije
TempMailg Webhook-ovi rade odmah iz kutije sa standardnim HTTPS krajnjim tačkama i vodećim platformama bez koda/automatizacije:
Uobičajene greške i otklanjanje problema
Ovo su najčešći odgovori koji možete videti tokom integracije korisničkog API-ja.
Nevažeći, nedostajući ili opozvani Bearer token.
Vlasništvo, dozvole za funkcije, pristup domeni ili veličina priloga sprečili su operaciju. Proverite kod odgovora i poruku.
Resurs nije pronađen na dozvoljenom hostu ili ne pripada korisniku.
Ključ operacije je ponovo upotrebljen sa različitim detaljima, druga operacija je u toku, ili je promenjena sigurnost poštanskog sandučeta. Pregledajte kod pre ponovnog pokušaja.
Mailbox je istekao ili je neaktivan.
Nevažeći parametri, nedozvoljeno trajanje, nedostupan kapacitet aliasa, nevažeća PIN konfiguracija ili nedostajući/nevažeći Idempotency-Key sprečio je operaciju.
Zaštićeno poštansko sanduče zahteva važeći ograničeni X-Mailbox-Unlock token. Koristite akciju i target_id iz odgovora za brisanje. Zahtevi za zaključavanje ili oporavak moraju biti rešeni pre ponovnog pokušaja.
Ograničenje zahteva, onemogućen plan, iscrpljena kvota ili hlađenje sprečili su operaciju. Proverite razlog i zaglavlja dostupnog budžeta. Retry-After je opciono.
Server nije mogao da dovrši operaciju. Za zaštićeno kreiranje ili brisanje, sačuvajte isti zahtev i Idempotency-Key prilikom ponovnog pokušaja.
Zaštita skladištenja ili koordinacija nije mogla biti verifikovana. Pokušajte ponovo nakon naznačenog kašnjenja. Ovaj odgovor nije neuspešna uplata.
Brza lista
- 401 Unauthorized - Bearer token nedostaje, je pogrešan, povučen ili kopiran netačno.
- 403 Forbidden - Trenutni plan ne ima pravo pristupa korisničkom API-u u ovom trenutku.
- 404 Not Found - Resurs nije pronađen ili nevažeći parametar
- 410 Gone / Expired - Mailbox je istekao ili nije više aktivan.
- 429 Rate Limited - Proverite razlog odgovora i zaglavlja budžeta. Retry-After se primenjuje samo na vremenska ograničenja; iscrpljeni krediti ili onemogućen pristup mogu zahtevati promenu naloga.
Preporučeni sledeći korak
Ako ste prijavljeni, otvorite API Management prvo i potvrdite svoj ključ, status kvote, plan pristupa i tačan User API Base URL pre debugovanja vašeg spoljašnjeg aplikacija.