Lista de verificare a configurării rapide
- Deschideți pagina de gestionare a API din panoul dvs. de control și creați cheia dvs. API personală.
- Copiați exact URL-ul de bază al API-ului de utilizator afișat acolo, de exemplu https://v1.tempmailg.com/api.
- Trimiteți fiecare cerere către acea gazdă API cu Authorization: Bearer YOUR_USER_API_KEY și Accept: application/json.
- Urmărește cota lunară de cereri din aceeași pagină de bord și din anteturile de cotă când sunt disponibile în răspunsurile API ale utilizatorului. Doar cererile de succes 2xx contează la cotă.
Acces cheie API
Conectați-vă pentru a crea cheia dvs. personală API și pentru a vizualiza detalii live ale cotei.
Fluxul de autentificare
- Generați cheia dvs. personală API de pe pagina de management al API-ului din tablă de bord.
- Trimiteți cheia ca token Bearer în fiecare solicitare.
- Utilizați URL-ul de bază dedicat al API-ului Utilizator, afișat pe pagina dvs. de management al API-ului.
- Regenerați cheia oricând doriți să anulați cea veche și să începeți să utilizați o cheie nouă imediat.
Antete obligatorii
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Antete limită de rată și cotă
Anteturile de limitare a ratei descriu bugetul de cereri indicat. Anteturile de cotă sunt incluse când informațiile despre cotă sunt disponibile; refuzurile de limită pe minut nu calculează întreaga cotă lunară.
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— Numărul maxim de cereri permise pe minut (RPM) pentru planul tău.X-RateLimit-Remaining— Cereri RPM rămase în fereastra curentă de un minut.X-RateLimit-Reset— Marcaj de timp Unix când se resetează fereastra de limită de rată pentru minutul curent.X-Quota-Limit— Capacitatea totală lunară și de credit achiziționat pentru contul tău.X-Quota-Remaining— Cereri API disponibile rămase în luna curentă.X-Quota-Used— Totalul cererilor API consumate în perioada curentă de facturare.X-Quota-Reset— Marcaj de timp ISO-8601 când se resetează cota lunară.X-RateLimit-Scope— Bugetul descris de antetele: account, ip, status_endpoint, sau mailbox.X-Mailbox-RateLimit-*— Buget separat pentru crearea/actualizarea cutiei poștale. Răspunsurile de cutie poștală reușite păstrează RPM-ul contului în X-RateLimit-*; o respingere doar pentru cutia poștală folosește domeniul cutiei poștale și propria fereastră de reîncercare.Retry-After— Secunde până când o reîncercare temporizată este adecvată. Un plan dezactivat sau o cotă epuizată poate necesita în schimb o schimbare de cont, astfel că acest antet nu este întotdeauna prezent.503 protection_unavailable— Stocarea sau coordonarea protecției API este temporar indisponibilă. Încercați din nou mai târziu; aceasta nu este o eroare de plată sau o debitare de credit.
Gestionarea căsuței poștale
Obține domeniile permise, creează sau schimbă cutiile poștale, alege duratele permise și șterge adresele deținute.
Listă de domenii permise
Listați domeniile disponibile pentru crearea de e‑mailuri temporare. Filtrați după tip pentru a vedea doar domeniile gratuite, premium sau personalizate suportate de planul dvs. de abonament.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
type
|
query | string | opțional |
Filtru nivel domeniu. Omiterea folosește toate când accesul la domeniu premium este activat, altfel gratuit. Valori recunoscute: free, basic, pro, premium, custom, ultimate, all
Implicit:
Depinde de cont
|
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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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
}
]
}
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
data.requested_type |
string | Filtru de domeniu aplicat. |
data.plan |
string | Etichetă plan curent. |
data.plan_name |
string | Nume lizibil al planului curent. |
data.allowed_types |
array<string> | Filtre de domeniu disponibile pentru acest cont. Un filtru recunoscut poate fi în continuare interzis pentru planul tău. |
data.domains |
array | Domenii selectabile după filtrare; un array gol este valid. |
data.domains[].domain |
string | Nume de domeniu selectabil. |
data.domains[].type |
string | Etichetă de nivel de domeniu citibil. |
data.domains[].custom |
boolean | Dacă acesta este un domeniu personalizat. |
Creează căsuță poștală temporară
Creează o cutie poștală temporară deținută. Omită numele de utilizator și domeniul pentru generare aleatorie, sau furnizează un nume de utilizator personalizat permis și un domeniu permis. Parametrul provider poate selecta generarea de alias Gmail sau Outlook.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
username
|
body | string | opțional |
Nume de utilizator personalizat opțional: 2 până la 64 de litere ASCII, cifre, puncte, sublinieri sau liniuțe. Necesită permisiune de plan; custom_username este, de asemenea, acceptat.
Implicit:
Generat aleatoriu
|
domain
|
body | string | opțional |
Unul dintre domeniile permise returnate de GET /domains. Omiterea alege un domeniu permis aleatoriu.
Implicit:
Domeniu permis aleatoriu
|
lifetime
|
body | string | opțional |
valori permise:
10m — 10 minute
1h — 1 Oră
2h — 2 Ore
1d — 1 zi
1w — 1 Săptămână
1m — 30 de zile
3m — 90 de zile
6m — 180 de zile
1y — 365 de zile
unlimited — Nelimitat
Implicit:
Durata de viață implicită a planului
|
provider
|
body | string | opțional |
Furnizor de căsuță poștală: standard, gmail_alias, sau outlook_alias.
Implicit:
standard
|
pin_enabled
|
body | boolean | opțional |
Protecție PIN opțională pentru cutia poștală nouă, când este permisă de planul tău. Nu modifică PIN-ul unei cutii poștale existente.
Implicit:
false
|
pin
|
body | string | opțional |
Necesar când pin_enabled este true: un PIN de 6 până la 8 cifre, trimis ca șir pentru a păstra zerourile de la început.
|
pin_confirmation
|
body | string | opțional |
Necesar când pin_enabled este true. Trebuie să se potrivească exact cu pin.
|
Idempotency-Key
|
header | string | opțional |
Necesar pentru crearea sau ștergerea protejată prin PIN: o cheie stabilă de la 16 la 128 de caractere. Reîncearcă aceeași cerere cu aceeași cheie pentru a evita munca duplicată.
|
username (nume de utilizator personalizat dacă este permis de plan), domain (domeniu permis, de ex. example.com), lifetime (valori permise: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Omite durata de viață sau lasă-l gol pentru a utiliza Durata de viață implicită a e-mailului configurată pentru planul tău lunar/anual curent. Trimite o durată de viață permisă, cum ar fi 1h, pentru a suprascrie acea valoare implicită. Nelimitat este utilizat numai când este configurat ca valoare implicită a planului sau este solicitat explicit și permis. Parametrii din corp mailbox_lifetime și email_lifetime sunt, de asemenea, acceptați; prima valoare nenulă câștigă în această ordine: lifetime, mailbox_lifetime, email_lifetime. Valorile invalide sau nepermise returnează HTTP 422 în loc să selecteze în tăcere o valoare implicită.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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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:55+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:55+00:00",
"email_token": "encrypted-email-token"
}
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
data.id |
integer | ID-ul căsuței poștale. ID-urile generate, adresele și token-urile diferă pentru fiecare căsuță poștală. |
data.pin_protected |
boolean | Indică dacă această căsuță poștală are protecție PIN. Nu se returnează niciun PIN sau hash al PIN-ului. |
data.email |
string | Adresa completă a căsuței poștale a fost generată. |
data.domain |
string | Domeniul cutiei poștale generate. |
data.provider |
string | Furnizor de căsuță poștală: standard, gmail_alias, sau outlook_alias. |
data.expire_at |
string|null | Expirarea efectivă ca un timestamp ISO-8601, sau null pentru o cutie poștală nelimitată. |
data.expires_in_seconds |
number|null | Secunde rămase nenegative când se calculează; secunde fracționare sunt posibile. Null înseamnă nelimitat, nu zero. |
data.mailbox_state |
string | Starea actuală a căsuței poștale: activă, în pauză, expirată sau inactivă. |
data.receiving_enabled |
boolean | Dacă această cutie poștală acceptă în prezent mesaje primite. |
data.message_count |
integer | Număr total de mesaje cunoscut; poate reflecta ultima sincronizare a cutiei poștale. |
data.unread_message_count |
integer | Număr cunoscut de mesaje necitite; poate reflecta ultima sincronizare a căsuței poștale. |
data.last_message_received_at |
string|null | Ultimul timp cunoscut al mesajului primit în format ISO-8601, sau null când nu este disponibil. |
data.message_count_synced_at |
string|null | Ultimul timp de sincronizare a numărului de mesaje în format ISO-8601, sau null înainte de sincronizare. |
data.created_at |
string|null | Ora creării căsuței poștale în format ISO-8601. |
data.email_token |
string | Referință criptată opacă a căsuței poștale. Nu înlocuiește autentificarea Bearer, verificările de proprietate sau autorizarea PIN. |
data.pin_grant |
object | Condițional: crearea activă a unei căsuțe de e-mail protejate cu PIN returnează această permisiune de citire; crearea obișnuită neprotejată o omite. |
data.pin_grant.mailbox_id |
integer | ID-ul căsuței poștale la care este legată autorizația condițională de citire. |
data.pin_grant.unlock_token |
string | Token de citire opac pentru X-Mailbox-Unlock cu aceeași acreditare a proprietarului. Păstrează-l privat și în memorie; o autorizație de citire nu autorizează ștergerea. |
data.pin_grant.scope |
string | Domeniul citit pentru acordul de creare condițională. |
data.pin_grant.idle_timeout_seconds |
integer | Timpul de inactivitate permis pentru acordul de citire, în mod normal 3600 de secunde. |
data.pin_grant.absolute_timeout_seconds |
integer | Durata maximă de viață a permisiunii de citire, în mod normal 86400 de secunde. |
data.pin_grant.expires_at |
string | Expirarea curentă a permisiunii de citire în format ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Expirarea absolută a acordului de citire în format ISO-8601. Modificările de securitate pot revoca acordul mai devreme. |
Actualizează / Schimbă cutia poștală
Crează sau selectează o cutie poștală la noul nume de utilizator și domeniu după ce verifici deținerea cutiei poștale curente. Aceasta nu redenumește vechea cutie poștală și nu îi modifică durata de viață în loc. Când destinația diferă, vechea cutie poștală rămâne în istoric și poate fi întreruptă de limitele cutiilor poștale active. Reutilizarea propriei destinații active reaplică durata de viață solicitată sau setarea implicită a planului.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
email
|
path | string | obligatoriu |
Adresa de e‑mail completă curentă a căsuței poștale deținute pentru schimbare. Codificați URL fiecare segment de cale; codificați semnul plus ca %2B.
|
username
|
path | string | obligatoriu |
Noul nume de utilizator dorit: 2 până la 64 de caractere alfanumerice; supus permisiunii pentru nume de utilizator personalizat.
|
domain
|
path | string | obligatoriu |
Nume de domeniu permis nou.
|
lifetime
|
body | string | opțional |
valori permise:
10m — 10 minute
1h — 1 Oră
2h — 2 Ore
1d — 1 zi
1w — 1 Săptămână
1m — 30 de zile
3m — 90 de zile
6m — 180 de zile
1y — 365 de zile
unlimited — Nelimitat
Implicit:
Durata de viață implicită a planului
|
pin_enabled
|
body | boolean | opțional |
Protecție PIN opțională pentru cutia poștală nouă, când este permisă de planul tău. Nu modifică PIN-ul unei cutii poștale existente.
Implicit:
false
|
pin
|
body | string | opțional |
Necesar când pin_enabled este true: un PIN de 6 până la 8 cifre, trimis ca șir pentru a păstra zerourile de la început.
|
pin_confirmation
|
body | string | opțional |
Necesar când pin_enabled este true. Trebuie să se potrivească exact cu pin.
|
Idempotency-Key
|
header | string | opțional |
Necesar pentru crearea sau ștergerea protejată prin PIN: o cheie stabilă de la 16 la 128 de caractere. Reîncearcă aceeași cerere cu aceeași cheie pentru a evita munca duplicată.
|
X-Mailbox-Unlock
|
header | string | opțional |
Antet, doar cutii poștale protejate: folosiți un unlock_token de citire. Mai întâi trimiteți un POST cu pin și scope=read la URL-ul de deblocare PIN. Păstrați autentificarea normală Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
lifetime (valori permise: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Omite durata de viață sau lasă-l gol pentru a utiliza Durata de viață implicită a e-mailului configurată pentru planul tău lunar/anual curent. Trimite o durată de viață permisă, cum ar fi 1h, pentru a suprascrie acea valoare implicită. Nelimitat este utilizat numai când este configurat ca valoare implicită a planului sau este solicitat explicit și permis. Parametrii din corp mailbox_lifetime și email_lifetime sunt, de asemenea, acceptați; prima valoare nenulă câștigă în această ordine: lifetime, mailbox_lifetime, email_lifetime. Valorile invalide sau nepermise returnează HTTP 422 în loc să selecteze în tăcere o valoare implicită.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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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:55+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:55+00:00",
"email_token": "encrypted-email-token"
}
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
data.id |
integer | ID-ul căsuței poștale. ID-urile generate, adresele și token-urile diferă pentru fiecare căsuță poștală. |
data.pin_protected |
boolean | Indică dacă această căsuță poștală are protecție PIN. Nu se returnează niciun PIN sau hash al PIN-ului. |
data.email |
string | Adresa completă a căsuței poștale a fost generată. |
data.domain |
string | Domeniul cutiei poștale generate. |
data.provider |
string | Furnizor de căsuță poștală: standard, gmail_alias, sau outlook_alias. |
data.expire_at |
string|null | Expirarea efectivă ca un timestamp ISO-8601, sau null pentru o cutie poștală nelimitată. |
data.expires_in_seconds |
number|null | Secunde rămase nenegative când se calculează; secunde fracționare sunt posibile. Null înseamnă nelimitat, nu zero. |
data.mailbox_state |
string | Starea actuală a căsuței poștale: activă, în pauză, expirată sau inactivă. |
data.receiving_enabled |
boolean | Dacă această cutie poștală acceptă în prezent mesaje primite. |
data.message_count |
integer | Număr total de mesaje cunoscut; poate reflecta ultima sincronizare a cutiei poștale. |
data.unread_message_count |
integer | Număr cunoscut de mesaje necitite; poate reflecta ultima sincronizare a căsuței poștale. |
data.last_message_received_at |
string|null | Ultimul timp cunoscut al mesajului primit în format ISO-8601, sau null când nu este disponibil. |
data.message_count_synced_at |
string|null | Ultimul timp de sincronizare a numărului de mesaje în format ISO-8601, sau null înainte de sincronizare. |
data.created_at |
string|null | Ora creării căsuței poștale în format ISO-8601. |
data.email_token |
string | Referință criptată opacă a căsuței poștale. Nu înlocuiește autentificarea Bearer, verificările de proprietate sau autorizarea PIN. |
data.pin_grant |
object | Condițional: crearea activă a unei căsuțe de e-mail protejate cu PIN returnează această permisiune de citire; crearea obișnuită neprotejată o omite. |
data.pin_grant.mailbox_id |
integer | ID-ul căsuței poștale la care este legată autorizația condițională de citire. |
data.pin_grant.unlock_token |
string | Token de citire opac pentru X-Mailbox-Unlock cu aceeași acreditare a proprietarului. Păstrează-l privat și în memorie; o autorizație de citire nu autorizează ștergerea. |
data.pin_grant.scope |
string | Domeniul citit pentru acordul de creare condițională. |
data.pin_grant.idle_timeout_seconds |
integer | Timpul de inactivitate permis pentru acordul de citire, în mod normal 3600 de secunde. |
data.pin_grant.absolute_timeout_seconds |
integer | Durata maximă de viață a permisiunii de citire, în mod normal 86400 de secunde. |
data.pin_grant.expires_at |
string | Expirarea curentă a permisiunii de citire în format ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Expirarea absolută a acordului de citire în format ISO-8601. Modificările de securitate pot revoca acordul mai devreme. |
Șterge căsuța poștală
Șterge o cutie poștală deținută și declanșează curățarea mesajelor și fișierelor sale. Înregistrările de cutie poștală păstrate pot fi șterse soft intern; adresa nu mai este utilizabilă prin API.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
email
|
path | string | obligatoriu |
Adresa de e‑mail completă a căsuței poștale deținută care urmează să fie ștearsă. Codificați adresa în URL; codificați semnul plus ca %2B.
|
X-Mailbox-Unlock
|
header | string | opțional |
Antet, numai pentru cutiile poștale protejate: utilizați tokenul de deblocare pentru ștergere cu o singură utilizare. Mai întâi POST pin, scope=delete și acțiunea/target_id returnate de răspunsul 423 la URL-ul de deblocare PIN. Un token de citire nu poate șterge. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | opțional |
Necesar pentru crearea sau ștergerea protejată prin PIN: o cheie stabilă de la 16 la 128 de caractere. Reîncearcă aceeași cerere cu aceeași cheie pentru a evita munca duplicată.
|
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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
200 OK • JSON{
"status": true,
"message": "Email has been successfully deleted."
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
message |
string | Rezultatul ștergerii. O resursă lipsă returnează HTTP 404. |
Aliasuri Gmail și Outlook
Generează cutii poștale alias Gmail și Outlook/Hotmail cu reputație ridicată.
Creează alias Gmail
Creează o nouă cutie poștală temporară alias Gmail deținută de utilizatorul autentificat.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
mode
|
body | string | opțional |
Mod de generare: auto, dot, plus sau plus_dot. Acceptă, de asemenea, gmail_alias_mode. Dacă selecția stilului nu este permisă, se folosește auto.
Implicit:
auto
|
username
|
body | string | opțional |
Sufix opțional de alias personalizat: 2 până la 32 de litere sau cifre ASCII, normalizat la litere mici; supus permisiunii funcționalității. De asemenea, acceptă custom_username sau alias_username.
Implicit:
Generat automat
|
domain
|
body | string | opțional |
Folosiți aleatoriu, gmail.com sau googlemail.com; alias_domain este, de asemenea, acceptat. Omiterea sau lipsa permisiunii de selectare a domeniului utilizează aleatoriu.
Implicit:
random
|
lifetime
|
body | string | opțional |
valori permise:
10m — 10 minute
1h — 1 Oră
2h — 2 Ore
1d — 1 zi
1w — 1 Săptămână
1m — 30 de zile
3m — 90 de zile
6m — 180 de zile
1y — 365 de zile
unlimited — Nelimitat
Implicit:
Durata de viață implicită a planului
|
pin_enabled
|
body | boolean | opțional |
Protecție PIN opțională pentru cutia poștală nouă, când este permisă de planul tău. Nu modifică PIN-ul unei cutii poștale existente.
Implicit:
false
|
pin
|
body | string | opțional |
Necesar când pin_enabled este true: un PIN de 6 până la 8 cifre, trimis ca șir pentru a păstra zerourile de la început.
|
pin_confirmation
|
body | string | opțional |
Necesar când pin_enabled este true. Trebuie să se potrivească exact cu pin.
|
Idempotency-Key
|
header | string | opțional |
Necesar pentru crearea sau ștergerea protejată prin PIN: o cheie stabilă de la 16 la 128 de caractere. Reîncearcă aceeași cerere cu aceeași cheie pentru a evita munca duplicată.
|
mode (auto, dot, plus, plus_dot), username (alias personalizat utilizator), domain (de ex. gmail.com, googlemail.com), lifetime (valori permise: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Omite durata de viață sau lasă-l gol pentru a utiliza Durata de viață implicită a e-mailului configurată pentru planul tău lunar/anual curent. Trimite o durată de viață permisă, cum ar fi 1h, pentru a suprascrie acea valoare implicită. Nelimitat este utilizat numai când este configurat ca valoare implicită a planului sau este solicitat explicit și permis. Parametrii din corp mailbox_lifetime și email_lifetime sunt, de asemenea, acceptați; prima valoare nenulă câștigă în această ordine: lifetime, mailbox_lifetime, email_lifetime. Valorile invalide sau nepermise returnează HTTP 422 în loc să selecteze în tăcere o valoare implicită.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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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:55+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:55+00:00",
"email_token": "encrypted-email-token"
}
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
data.id |
integer | ID-ul căsuței poștale. ID-urile generate, adresele și token-urile diferă pentru fiecare căsuță poștală. |
data.pin_protected |
boolean | Indică dacă această căsuță poștală are protecție PIN. Nu se returnează niciun PIN sau hash al PIN-ului. |
data.email |
string | Adresa completă a căsuței poștale a fost generată. |
data.domain |
string | Domeniul cutiei poștale generate. |
data.provider |
string | Furnizor de căsuță poștală: standard, gmail_alias, sau outlook_alias. |
data.expire_at |
string|null | Expirarea efectivă ca un timestamp ISO-8601, sau null pentru o cutie poștală nelimitată. |
data.expires_in_seconds |
number|null | Secunde rămase nenegative când se calculează; secunde fracționare sunt posibile. Null înseamnă nelimitat, nu zero. |
data.mailbox_state |
string | Starea actuală a căsuței poștale: activă, în pauză, expirată sau inactivă. |
data.receiving_enabled |
boolean | Dacă această cutie poștală acceptă în prezent mesaje primite. |
data.message_count |
integer | Număr total de mesaje cunoscut; poate reflecta ultima sincronizare a cutiei poștale. |
data.unread_message_count |
integer | Număr cunoscut de mesaje necitite; poate reflecta ultima sincronizare a căsuței poștale. |
data.last_message_received_at |
string|null | Ultimul timp cunoscut al mesajului primit în format ISO-8601, sau null când nu este disponibil. |
data.message_count_synced_at |
string|null | Ultimul timp de sincronizare a numărului de mesaje în format ISO-8601, sau null înainte de sincronizare. |
data.created_at |
string|null | Ora creării căsuței poștale în format ISO-8601. |
data.email_token |
string | Referință criptată opacă a căsuței poștale. Nu înlocuiește autentificarea Bearer, verificările de proprietate sau autorizarea PIN. |
data.pin_grant |
object | Condițional: crearea activă a unei căsuțe de e-mail protejate cu PIN returnează această permisiune de citire; crearea obișnuită neprotejată o omite. |
data.pin_grant.mailbox_id |
integer | ID-ul căsuței poștale la care este legată autorizația condițională de citire. |
data.pin_grant.unlock_token |
string | Token de citire opac pentru X-Mailbox-Unlock cu aceeași acreditare a proprietarului. Păstrează-l privat și în memorie; o autorizație de citire nu autorizează ștergerea. |
data.pin_grant.scope |
string | Domeniul citit pentru acordul de creare condițională. |
data.pin_grant.idle_timeout_seconds |
integer | Timpul de inactivitate permis pentru acordul de citire, în mod normal 3600 de secunde. |
data.pin_grant.absolute_timeout_seconds |
integer | Durata maximă de viață a permisiunii de citire, în mod normal 86400 de secunde. |
data.pin_grant.expires_at |
string | Expirarea curentă a permisiunii de citire în format ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Expirarea absolută a acordului de citire în format ISO-8601. Modificările de securitate pot revoca acordul mai devreme. |
Domenii alias Outlook
Obține domeniile alias active Outlook / Hotmail disponibile pentru generarea cutiei poștale.
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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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
}
]
}
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
data.domains |
array | Domenii Outlook/Hotmail active; un array gol este valid. |
data.domains[].domain |
string | Nume de domeniu disponibil. |
data.domains[].type |
string | Etichetă de furnizor lizibilă. |
data.domains[].selectable |
boolean | Dacă contul dvs. poate alege explicit acest domeniu. |
data.domains[].locked |
boolean | Dacă selecția explicită a domeniului este blocată pentru contul tău. |
data.domains[].disabled_reason |
string|null | Motivul pentru care selecția domeniului este blocată, sau null când este selectabil. |
Creează alias Outlook
Creează o nouă cutie poștală temporară alias Outlook / Hotmail deținută de utilizatorul autentificat.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
domain
|
body | string | opțional |
Utilizați aleatoriu sau un domeniu din GET /outlook-alias/domains; outlook_alias_domain este, de asemenea, acceptat. Fără permisiunea de selecție, se folosește aleatoriu.
Implicit:
Domeniu disponibil aleatoriu
|
username
|
body | string | opțional |
Sufix opțional de alias personalizat: 2 până la 32 de litere sau cifre ASCII, normalizat la litere mici; supus permisiunii funcționalității. De asemenea, acceptă custom_username sau alias_username.
Implicit:
Generat automat
|
lifetime
|
body | string | opțional |
valori permise:
10m — 10 minute
1h — 1 Oră
2h — 2 Ore
1d — 1 zi
1w — 1 Săptămână
1m — 30 de zile
3m — 90 de zile
6m — 180 de zile
1y — 365 de zile
unlimited — Nelimitat
Implicit:
Durata de viață implicită a planului
|
pin_enabled
|
body | boolean | opțional |
Protecție PIN opțională pentru cutia poștală nouă, când este permisă de planul tău. Nu modifică PIN-ul unei cutii poștale existente.
Implicit:
false
|
pin
|
body | string | opțional |
Necesar când pin_enabled este true: un PIN de 6 până la 8 cifre, trimis ca șir pentru a păstra zerourile de la început.
|
pin_confirmation
|
body | string | opțional |
Necesar când pin_enabled este true. Trebuie să se potrivească exact cu pin.
|
Idempotency-Key
|
header | string | opțional |
Necesar pentru crearea sau ștergerea protejată prin PIN: o cheie stabilă de la 16 la 128 de caractere. Reîncearcă aceeași cerere cu aceeași cheie pentru a evita munca duplicată.
|
domain (de ex. outlook.com, hotmail.com), username (alias personalizat utilizator), lifetime (valori permise: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Omite durata de viață sau lasă-l gol pentru a utiliza Durata de viață implicită a e-mailului configurată pentru planul tău lunar/anual curent. Trimite o durată de viață permisă, cum ar fi 1h, pentru a suprascrie acea valoare implicită. Nelimitat este utilizat numai când este configurat ca valoare implicită a planului sau este solicitat explicit și permis. Parametrii din corp mailbox_lifetime și email_lifetime sunt, de asemenea, acceptați; prima valoare nenulă câștigă în această ordine: lifetime, mailbox_lifetime, email_lifetime. Valorile invalide sau nepermise returnează HTTP 422 în loc să selecteze în tăcere o valoare implicită.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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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:55+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:55+00:00",
"email_token": "encrypted-email-token"
}
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
data.id |
integer | ID-ul căsuței poștale. ID-urile generate, adresele și token-urile diferă pentru fiecare căsuță poștală. |
data.pin_protected |
boolean | Indică dacă această căsuță poștală are protecție PIN. Nu se returnează niciun PIN sau hash al PIN-ului. |
data.email |
string | Adresa completă a căsuței poștale a fost generată. |
data.domain |
string | Domeniul cutiei poștale generate. |
data.provider |
string | Furnizor de căsuță poștală: standard, gmail_alias, sau outlook_alias. |
data.expire_at |
string|null | Expirarea efectivă ca un timestamp ISO-8601, sau null pentru o cutie poștală nelimitată. |
data.expires_in_seconds |
number|null | Secunde rămase nenegative când se calculează; secunde fracționare sunt posibile. Null înseamnă nelimitat, nu zero. |
data.mailbox_state |
string | Starea actuală a căsuței poștale: activă, în pauză, expirată sau inactivă. |
data.receiving_enabled |
boolean | Dacă această cutie poștală acceptă în prezent mesaje primite. |
data.message_count |
integer | Număr total de mesaje cunoscut; poate reflecta ultima sincronizare a cutiei poștale. |
data.unread_message_count |
integer | Număr cunoscut de mesaje necitite; poate reflecta ultima sincronizare a căsuței poștale. |
data.last_message_received_at |
string|null | Ultimul timp cunoscut al mesajului primit în format ISO-8601, sau null când nu este disponibil. |
data.message_count_synced_at |
string|null | Ultimul timp de sincronizare a numărului de mesaje în format ISO-8601, sau null înainte de sincronizare. |
data.created_at |
string|null | Ora creării căsuței poștale în format ISO-8601. |
data.email_token |
string | Referință criptată opacă a căsuței poștale. Nu înlocuiește autentificarea Bearer, verificările de proprietate sau autorizarea PIN. |
data.pin_grant |
object | Condițional: crearea activă a unei căsuțe de e-mail protejate cu PIN returnează această permisiune de citire; crearea obișnuită neprotejată o omite. |
data.pin_grant.mailbox_id |
integer | ID-ul căsuței poștale la care este legată autorizația condițională de citire. |
data.pin_grant.unlock_token |
string | Token de citire opac pentru X-Mailbox-Unlock cu aceeași acreditare a proprietarului. Păstrează-l privat și în memorie; o autorizație de citire nu autorizează ștergerea. |
data.pin_grant.scope |
string | Domeniul citit pentru acordul de creare condițională. |
data.pin_grant.idle_timeout_seconds |
integer | Timpul de inactivitate permis pentru acordul de citire, în mod normal 3600 de secunde. |
data.pin_grant.absolute_timeout_seconds |
integer | Durata maximă de viață a permisiunii de citire, în mod normal 86400 de secunde. |
data.pin_grant.expires_at |
string | Expirarea curentă a permisiunii de citire în format ISO-8601. |
data.pin_grant.absolute_expires_at |
string | Expirarea absolută a acordului de citire în format ISO-8601. Modificările de securitate pot revoca acordul mai devreme. |
Mesaje și atașamente
Recuperează căsuțele de intrare primite, citește mesajele complete în HTML/text și transmite atașamentele în flux.
Listează mesajele din cutia poștală
Recuperează rezumatele mesajelor disponibile și metadatele căsuței poștale. Scanările standard ale inboxului returnează un lot recent de până la 25 de mesaje; acesta nu este un punct final paginat cu istoric complet. Folosește GET /messages/{messageId} pentru corpurile complete și atașamente.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
email
|
query | string | obligatoriu |
Adresa completă de e‑mail a căsuței de poștă deținută pentru a citi mesajele. Codificați în URL valoarea interogării; codificați semnul plus ca %2B.
|
X-Mailbox-Unlock
|
header | string | opțional |
Antet, doar cutii poștale protejate: folosiți un unlock_token de citire. Mai întâi trimiteți un POST cu pin și scope=read la URL-ul de deblocare PIN. Păstrați autentificarea normală Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages?email=demo123@example.com' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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:55",
"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:55+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:55+00:00",
"message_count_synced_at": "2026-11-19T02:17:55+00:00"
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
mailbox |
string | Adresa căsuței poștale ale cărei mesaje au fost solicitate. |
email_token |
string | Referință opacă criptată a căsuței poștale; autentificarea normală este încă necesară. |
mailbox_provider |
string | Furnizor de căsuță poștală: standard, gmail_alias, sau outlook_alias. |
messages |
array | Rezumat de mesaje. O căsuță de intrare goală returnează un tablou gol; preia un singur mesaj pentru corpul și atașamentele sale. |
expire_at |
string|null | Expirarea efectivă ca un timestamp ISO-8601, sau null pentru o cutie poștală nelimitată. |
expires_in_seconds |
number|null | Secunde rămase nenegative când se calculează; secunde fracționare sunt posibile. Null înseamnă nelimitat, nu zero. |
mailbox_state |
string | Starea actuală a căsuței poștale: activă, în pauză, expirată sau inactivă. |
receiving_enabled |
boolean | Dacă această cutie poștală acceptă în prezent mesaje primite. |
message_count |
integer | Număr total de mesaje cunoscut; poate reflecta ultima sincronizare a cutiei poștale. |
unread_message_count |
integer | Număr cunoscut de mesaje necitite; poate reflecta ultima sincronizare a căsuței poștale. |
last_message_received_at |
string|null | Ultimul timp cunoscut al mesajului primit în format ISO-8601, sau null când nu este disponibil. |
message_count_synced_at |
string|null | Ultimul timp de sincronizare a numărului de mesaje în format ISO-8601, sau null înainte de sincronizare. |
mailbox_limit.limit |
integer | Limita activă a cutiilor poștale pentru acest furnizor; -1 înseamnă nelimitat. |
mailbox_limit.limit_label |
string | Etichetă de afișare pentru limita căsuței poștale. |
mailbox_limit.active_count |
integer | Numărul de cutii poștale active pentru acest furnizor. |
mailbox_limit.paused_count |
integer | Numărul de cutii poștale puse în pauză pentru acest furnizor. |
mailbox_limit.paused_mailboxes |
array<string> | Adresele au fost întrerupte din cauza limitei căsuței poștale. |
mailbox_limit.remaining |
integer | Sloturi de căsuță poștală activă rămase; -1 înseamnă nelimitat. Aceasta nu este cota de cereri API. |
mailbox_limit.remaining_label |
string | Afișează eticheta pentru sloturile de cutie poștală rămase. |
mailbox_limit.reached |
boolean | Dacă limita de căsuțe poștale active a fost atinsă. |
mailbox_limit.blocked |
boolean | Dacă limita de căsuță poștală activă este zero. |
mailbox_limit.provider |
string|null | Furnizorul la care se aplică limita cutiei poștale. |
messages[].id |
string | ID mesaj opac utilizat de punctele finale pentru mesaj unic, ștergere și atașament. |
messages[].is_seen |
boolean | Dacă mesajul este marcat ca citit. |
messages[].subject |
string | Subiectul mesajului. |
messages[].from |
string | Numele afișat al expeditorului sau adresa. |
messages[].from_email |
string | Adresa de e‑mail a expeditorului. |
messages[].receivedAt |
string | Ora primită în fusul orar al aplicației, formatată ca YYYY‑MM‑DD HH:mm:ss. |
messages[].otp |
string|null | Cod de unică folosință detectat când este disponibil și permis; altfel null. |
messages[].otp_locked |
boolean | Dacă un cod unic detectat este ascuns de permisiunile funcției. |
messages[].verification_link |
string|null | URL de verificare detectat când este disponibil și permis; altfel null. |
messages[].verification_link_locked |
boolean | Dacă un link de verificare detectat este ascuns de permisiunile funcționalității. |
messages[].from_name |
string|null | Câmp de rezumat Outlook: numele expeditorului original. Lipsă din rezumatele Standard și Gmail. |
messages[].snippet |
string|null | Câmp rezumat Outlook: previzualizare scurtă a mesajului. |
messages[].received_at |
string|null | Câmp rezumat Outlook: timpul primit în format ISO-8601, când este cunoscut. |
messages[].has_attachments |
boolean | Câmpul de rezumat Outlook: dacă există metadatele atașamentului. Disponibilitatea descărcării este verificată separat. |
Obține mesaj unic
Recuperați un mesaj deținut prin ID-ul său opac de mesaj. Returnează formatele corpului și metadatele atașamentelor. Câmpurile corpului depind de formatul mesajului; Outlook adaugă câmpuri specifice furnizorului enumerate mai jos.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
messageId
|
path | string | obligatoriu |
ID unic al mesajului returnat în lista de mesaje.
|
X-Mailbox-Unlock
|
header | string | opțional |
Antet, doar cutii poștale protejate: folosiți un unlock_token de citire. Mai întâi trimiteți un POST cu pin și scope=read la URL-ul de deblocare PIN. Păstrați autentificarea normală Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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:55",
"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"
}
]
}
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
data.id |
string | ID mesaj opac. |
data.is_seen |
boolean | Starea de citire a mesajului. Citirea poate marca ca văzut; datele în cache pot reflecta o stare anterioară. |
data.subject |
string | Subiectul mesajului. |
data.from |
string | Numele afișat al expeditorului sau adresa. |
data.from_email |
string | Adresa de e‑mail a expeditorului. |
data.to |
string | Adresa căsuței poștale a destinatarului. |
data.mailbox_provider |
string | Furnizor de căsuță poștală: standard, gmail_alias, sau outlook_alias. |
data.receivedAt |
string | Ora primită în fusul orar al aplicației, formatată ca YYYY‑MM‑DD HH:mm:ss. |
data.html |
boolean | Dacă mesajul are un corp HTML. |
data.html_content |
string | Corp HTML când este prezent. Mesajele standard fără HTML pot omite acest câmp. Tratați conținutul mesajului ca nesigur. |
data.text_content |
string | Corpul textului când este prezent; Mesajele standard pot conține text scăpat într-un element pre sau pot omite acest câmp. |
data.content |
string | Corp preferat pentru afișare, de obicei HTML când este disponibil. |
data.attachments |
array | Metadatele atașamentului, sau un tablou gol. Descărcările necesită autentificare normală și autorizare PIN aplicabilă. |
data.attachments[].name |
string | Nume de fișier de codificat în URL ca un singur segment de cale la descărcare. |
data.attachments[].size |
integer | Dimensiunea atașamentului în octeți. |
data.attachments[].url |
string | URL-ul de descărcare al API-ului utilizatorului autentificat a fost adăugat la atașamente cu un nume de fișier. Un URL nu garantează că fișierul local este disponibil. |
data.attachments[].extension |
string | Câmp de metadate Standard/Gmail: extensia fișierului când este furnizată. |
data.attachments[].id |
string | Câmp de metadate Outlook: ID atașament furnizor. |
data.attachments[].content_type |
string | Câmp de metadate Outlook: tipul de conținut MIME. |
data.from_name |
string|null | Câmp de detaliu Outlook: numele expeditorului original. |
data.to_email |
string|null | Câmp de detaliu Outlook: adresa destinatarului original. |
data.received_at |
string|null | Câmp detaliu Outlook: ora primită în format ISO-8601. |
data.has_html |
boolean | Câmp de detaliu Outlook: dacă există un corp HTML. |
Șterge mesajul
Ștergeți un singur mesaj deținut.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
messageId
|
path | string | obligatoriu |
String unic de ID al mesajului pentru ștergere permanentă.
|
X-Mailbox-Unlock
|
header | string | opțional |
Antet, numai pentru cutiile poștale protejate: utilizați tokenul de deblocare pentru ștergere cu o singură utilizare. Mai întâi POST pin, scope=delete și acțiunea/target_id returnate de răspunsul 423 la URL-ul de deblocare PIN. Un token de citire nu poate șterge. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | opțional |
Necesar pentru crearea sau ștergerea protejată prin PIN: o cheie stabilă de la 16 la 128 de caractere. Reîncearcă aceeași cerere cu aceeași cheie pentru a evita munca duplicată.
|
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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
200 OK • JSON{
"status": true,
"message": "Message was deleted successfully."
}
| Câmp | Tip | Descriere |
|---|---|---|
status |
boolean | Dacă operația a reușit. |
message |
string | Rezultatul ștergerii. O resursă lipsă returnează HTTP 404. |
Descarcă atașament
Descărcați o atașare dintr-un mesaj deținut.
| Parametru | Locație | Tip | Stare | Descriere |
|---|---|---|---|---|
messageId
|
path | string | obligatoriu |
ID-ul mesajului care conține fișierul.
|
filename
|
path | string | obligatoriu |
Numele fișierului și extensia atașamentului de descărcat.
|
X-Mailbox-Unlock
|
header | string | opțional |
Antet, doar cutii poștale protejate: folosiți un unlock_token de citire. Mai întâi trimiteți un POST cu pin și scope=read la URL-ul de deblocare PIN. Păstrați autentificarea normală Bearer. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()
with open('file.txt', 'wb') as handle:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
handle.write(chunk)
<?php
$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_FILE => $fileHandle,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
if (curl_exec($ch) === false) {
fclose($fileHandle);
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
fclose($fileHandle);
curl --request GET \
--url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY' \
--output file.txt
| Câmp | Tip | Descriere |
|---|---|---|
Content-Disposition |
header | Răspunsul de succes descarcă numele de fișier solicitat. |
body |
binary | Octeți de fișier la succes, nu JSON. Erorile returnează JSON cu un status non-2xx. |
Limite de rată și cote
Monitorizați bugetele de cereri în timp real, limitele de rată și cotele contului fără a consuma credite.
Limită de rată și cotă
Verificați limita curentă de rată și starea cotei fără a consuma utilizarea API. Acest punct final este fără cotă și nu deduce creditele lunare API (limită de protecție împotriva abuzului: 60 de cereri/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'
Răspuns ilustrativ utilizând date sintetice. ID-urile, adresele, token-urile, timestamp-urile, limitele și contorizările planului variază. Duratele de eșantion nu suprascriu setarea implicită a planului dumneavoastră. Descrierile câmpurilor de răspuns identifică câmpurile care pot fi nule și cele specifice furnizorului.
Exemplu de răspuns
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"
}
}
}
| Câmp | Tip | Descriere |
|---|---|---|
data.limit |
integer|string | Limita de cereri pe minut pentru cont. Șirul unlimited indică un buget nelimitat pe minut; aceasta este independentă de cota lunară. |
data.remaining |
integer|string | Sloturi rămase din bugetul de minute al contului, sau șirul unlimited. O valoare pozitivă nu înseamnă că creditele API rămân. |
data.reset |
integer | Secunde pentru fereastra de minut a contului, nu pentru resetarea cotei lunare. Bugetele de minut dezactivate sau nelimitate pot păstra o valoare nominală de 60 de secunde; aceasta nu promite acces după așteptare. |
data.plan |
string | Etichetă plan curent. Numele planului lizibil este furnizat separat în data.quota.plan_name. |
data.quota.enabled |
boolean | Indică dacă accesul global și cel pentru plan/credit la API este activat. Aceasta nu indică capacitatea rămasă și nu înlocuiește comutatorul API al utilizatorului. |
data.quota.user_api_status |
boolean | Dacă utilizatorul a activat comutatorul API al utilizatorului. Operaţiunile necesită acest comutator, precum şi accesul activat şi capacitatea disponibilă. |
data.quota.plan_name |
string | Nume lizibil al planului curent. |
data.quota.period |
string | Perioada de utilizare calendar-lunară în format YYYY-MM, utilizând fusul orar al aplicației; nu neapărat perioada de facturare a abonamentului. |
data.quota.base_limit |
integer | Alocație de bază lunară a planului. O valoare de -1 înseamnă nelimitat. |
data.quota.extra_requests |
integer | Alocație lunară suplimentară acordată pentru perioada curentă de utilizare; separată de creditele achiziționate. |
data.quota.monthly_limit |
integer | Alocația de bază plus cererile suplimentare din perioada curentă. O valoare de -1 înseamnă nelimitat. Creditele achiziționate nu sunt incluse. |
data.quota.monthly_remaining |
integer|null | Alocarea lunară finită rămasă, sau null când cota lunară este nelimitată. Null nu trebuie interpretat ca zero. |
data.quota.used |
integer | Operațiuni API reușite, contorizate în perioada curentă de utilizare, inclusiv operațiunile care utilizează credite. Verificările de stare nu cresc această valoare. |
data.quota.purchased_credits |
integer | Soldul curent de credite, inclusiv creditele bonus ale planului activ. Creditele bonus nu trebuie adăugate a doua oară la acest sold. |
data.quota.bonus_credits |
integer | Partea activă a bonusului de plan din soldul de credite; o defalcare a purchased_credits, nu capacitate suplimentară. |
data.quota.direct_purchased_credits |
integer | Soldul de credite excluzând partea de bonus activă a planului. Această valoare plus bonus_credits este egală cu purchased_credits. |
data.quota.remaining |
integer|null | Alocația lunară rămasă plus soldul curent de credit, fără a dubla bonusurile. Null înseamnă cotă lunară nelimitată. Permisiunile individuale pentru funcții și alte limite de cerere se aplică în continuare. |
data.quota.unlimited |
boolean | Dacă cota lunară este nelimitată. Aceasta nu face ca bugetul de minute al contului sau alte limite de funcționalități să fie nelimitate. |
data.quota.usage_percent |
integer | Procent rotunjit compatibil cu tabloul de bord, de la 0 la 100: utilizat împărțit la utilizat plus rămas, înmulțit cu 100. Include capacitatea de credit disponibilă, astfel că reîncărcarea poate scădea procentul. Este 0 pentru cotă nelimitată sau un pool de dimensiune zero; nu este procentul de limită pe minut sau o decizie de acces. |
data.quota.reset_at |
string | Marcaj temporal ISO-8601 cu decalaj de fus orar pentru resetarea cotei din următoarea lună calendaristică. Aceasta nu este data de expirare a abonamentului, iar resetarea lunară nu reîncarcă creditele achiziționate. |
status |
string | Succesul literal pentru acest punct final de stare. Alte puncte finale de cutie poștală reușite folosesc valoarea booleană true. |
data.monthly_limit |
integer | Alias de compatibilitate al câmpului data.quota corespunzător; nu îl adăugați din nou la calcularea soldurilor. |
data.monthly_remaining |
integer|null | Alias de compatibilitate al câmpului data.quota corespunzător; nu îl adăugați din nou la calcularea soldurilor. |
data.purchased_credits |
integer | Alias de compatibilitate al câmpului data.quota corespunzător; nu îl adăugați din nou la calcularea soldurilor. |
Webhooks pentru Mailbox (Trimiterere în timp real)
În loc să poluezi în mod repetat API-ul REST (GET /messages) pentru a verifica mesajele primite, configurează Webhook-uri pentru a trimite mesajele noi către serverul tău sau fluxul de automatizare în timp real.
Evenimente Webhook suportate
Fiecare webhook poate abona unul sau mai multe tipuri de evenimente. Endpoint-ul dvs. primește o notificare de eveniment în fiecare dată când unul dintre aceste declanșatoare se activează.
Trimis în timp real ori de câte ori un mesaj nou ajunge în căsuța poștală selectată.
Este trimis când căsuța poștală temporară expiră și procesarea webhook-ului este întreruptă.
Trimis când o cutie poștală expirată devine din nou activă conform regulilor planului.
Trimis chiar înainte ca webhook-ul și căsuța poștală să fie șterse.
Întrebări despre Capetele Cererii & Verificarea Semnăturii HMAC
Fiecare livrare prin webhook conține șiruri speciale de header-uri de securitate. Utilizați șirul de header X-TempMailg-Signature pentru a verifica că cererile primite au fost trimise autentic de TempMailg și nu au fost modificate.
| Nume Header | Valoare Exemplu | Descriere |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Identificator standard pentru lucrătorul de livrare webhook. |
X-TempMailg-Event |
email.received | Tipul de eveniment care a declanșat această livrare. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | UUID unic atribuit acestei încercări de livrare. |
X-TempMailg-Timestamp |
1725192000 | Marcaj de timp Unix epoch care indică momentul inițierii cererii. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | Semnătură HMAC-SHA256 calculată din {timestamp}.{raw_body} utilizând secretul tău. |
X-TempMailg-Test |
false | Adevărat când este trimis prin funcția "Send Test Ping" din tabloul de bord. |
Semnătura este calculată folosind HMAC cu SHA256 peste șirul:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Exemplu de Payload pentru Eveniment (email.received)
Trimis ca aplicație/json în corpul cererii HTTP POST.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:17:56+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:56+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"
}
}
Exemple de implementare a receptorului
Selectați limba pentru a vedea cum să primiți webhook-uri și să verificați semnăturile HMAC în mod securizat.
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]);
Platforme suportate și integrări de automatizare
Webhooks-urile TempMailg funcționează imediat cu puncte finale HTTPS standard și cu principalele platforme fără cod/automatizare:
Erori comune și depanare
Acestea sunt cele mai comune coduri de răspuns pe care le puteți vedea în timpul integrării API-ului utilizator.
Token Bearer invalid, lipsă sau revocat.
Deținerea, permisiunile funcționalității, accesul la domeniu sau dimensiunea atașamentului au împiedicat operațiunea. Verificați codul de răspuns și mesajul.
Resursa nu a fost găsită pe gazda permisă sau nu aparține utilizatorului.
Cheia operației a fost reutilizată cu detalii diferite, o altă operație este în așteptare sau securitatea căsuței poștale s-a schimbat. Inspectați codul înainte de a încerca din nou.
Cutia poștală a expirat sau este inactivă.
Parametri invalizi, o durată nepermisă, capacitate de alias indisponibilă, configurare PIN invalidă sau o cheie Idempotency-Key lipsă/invalidă au împiedicat operațiunea.
O căsuță poștală protejată necesită un token X-Mailbox-Unlock valid și cu domeniu. Folosește acțiunea și target_id din răspuns pentru ștergere. Cerințele de blocare sau recuperare trebuie rezolvate înainte de a încerca din nou.
O limită de cerere, plan dezactivat, cotă epuizată sau perioadă de răcire a împiedicat operațiunea. Verificați motivul și anteturile de buget disponibil. Retry-After este opțional.
Serverul nu a putut finaliza operațiunea. Pentru crearea sau ștergerea protejată, păstrați aceeași cerere și Idempotency-Key la reîncercare.
Stocarea protecției sau coordonarea nu a putut fi verificată. Încercaţi din nou după întârzierea indicată. Acest răspuns nu este o plată eșuată.
Listă rapidă de verificare
- 401 Unauthorized - Tokenul Bearer lipsește, este incorect, revocat sau copiat incorect.
- 403 Forbidden - Planul curent nu are acces la API-ul utilizator în prezent.
- 404 Not Found - Resursă ne găsită sau parametru invalid
- 410 Gone / Expired - Cutie poștală expirată sau nu mai este activă.
- 429 Rate Limited - Verificaţi motivul răspunsului şi anteturile bugetului. Retry-After se aplică numai limitelor temporale; creditele epuizate sau accesul dezactivat pot necesita o schimbare de cont.
Următorul pas recomandat
Dacă sunteți autentificat, deschideți mai întâi API Management și confirmați starea cheii, a cotei, a planului de acces și a exactei adrese de bază API Utilizator înainte de a deborda aplicația dvs. externă.