Documentația API TempMail

REST API v1 și Webhooks

TempMailg Documentație API pentru dezvoltatori

Folosiți această documentație pentru a genera cheia dvs. API personală, pentru a conecta gazda dedicată a API-ului de utilizator, pentru a citi mesajele din cutia poștală, pentru a gestiona cutiile poștale deținute și pentru a integra Temp Mail în aplicațiile sau automatizările dvs.

Autentificare cu token Bearer Webhook-uri în timp real Aliasuri Gmail și Outlook Răspunsuri JSON
URL de bază al API-ului Utilizator HTTPS
Formatul cererii Folosiți cheia dvs. API doar în antetul de autorizare Bearer și păstrați adresele URL ale punctelor de capăt curate.

Gestionarea căsuței poștale

Obține domeniile permise, creează sau schimbă cutiile poștale, alege duratele permise și șterge adresele deținute.

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

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.

Parametri 1
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
Obțineți domenii permise
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âmpuri de răspuns
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.
POST https://v1.tempmailg.com/api/emails
#

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.

Parametri 8
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ă.
Parametri opționali ai corpului: 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ă.
Creează cutie poștală
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âmpuri de răspuns
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.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

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.

Parametri 9
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>
Utilizați o adresă de e-mail existentă și deținută în {email}. Parametru opțional în corp: 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ă.
Actualizați cutia poștală deținută
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âmpuri de răspuns
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.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

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

Parametri 3
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ă.
Ștergeți cutia poștală deținută
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âmpuri de răspuns
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ă.

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

Creează alias Gmail

Creează o nouă cutie poștală temporară alias Gmail deținută de utilizatorul autentificat.

Parametri 8
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ă.
Necesită ca permisiunea Gmail Alias API să fie activată în planul tău de abonament sau deblocată printr-un pachet de credite API. Parametri opționali: 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ă.
Creează cutie poștală alias Gmail
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

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âmpuri de răspuns
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.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Domenii alias Outlook

Obține domeniile alias active Outlook / Hotmail disponibile pentru generarea cutiei poștale.

Necesită ca permisiunea Outlook Alias API să fie activată în planul tău de abonament sau deblocată printr-un pachet de credite API. Indică dacă selectarea unui domeniu specific este deblocată în planul tău.
Obține domeniile alias Outlook
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âmpuri de răspuns
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.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Creează alias Outlook

Creează o nouă cutie poștală temporară alias Outlook / Hotmail deținută de utilizatorul autentificat.

Parametri 7
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ă.
Necesită ca permisiunea Outlook Alias API să fie activată în planul tău de abonament sau deblocată printr-un pachet de credite API. Parametri opționali: 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ă.
Creează alias de cutie poștală Outlook
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âmpuri de răspuns
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.

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

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.

Parametri 2
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>
E-mailul trebuie să aparțină contului tău. Rezumatele standard și Gmail conțin câmpuri OTP și verification-link; Outlook include, de asemenea, from_name, snippet, received_at și has_attachments. Sincronizarea și caching-ul furnizorului pot întârzia mesajele noi și numărarea.
Citiți mesajele cutiei poștale
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âmpuri de răspuns
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.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

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.

Parametri 2
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>
Citiți un mesaj
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âmpuri de răspuns
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.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Șterge mesajul

Ștergeți un singur mesaj deținut.

Parametri 3
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ă.
Ștergeți un mesaj
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âmpuri de răspuns
Câmp Tip Descriere
status boolean
Dacă operația a reușit.
message string
Rezultatul ștergerii. O resursă lipsă returnează HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Descarcă atașament

Descărcați o atașare dintr-un mesaj deținut.

Parametri 3
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>
Succesul returnează octeți de fișier, nu JSON. Fișierele prea mari returnează HTTP 403; fișierele locale lipsă sau indisponibile returnează HTTP 404. Codificați URL numele fișierului ca un singur segment de cale. Metadatele atașamentului singure nu garantează disponibilitatea descărcării.
Descărcați o atașare
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
Comportamentul de descărcare Acest punct de capăt returnează fișierul solicitat direct, în loc de un corp JSON.
Câmpuri de răspuns
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.

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

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

X-RateLimit-* descrie bugetul de cereri indicat; X-Quota-* descrie capacitatea lunară și cea achiziționată când este disponibilă. X-Mailbox-RateLimit-* raportează bugetul separat pentru crearea/actualizarea căsuței poștale. O respingere doar pentru căsuța poștală folosește domeniul căsuței poștale și propria fereastră de reîncercare. Respingerile cu limită pe minut pot omite informațiile despre cotă. Retry-After este inclus doar pentru o reîncercare temporizată; accesul dezactivat poate necesita o schimbare de cont. În acest răspuns de stare de succes, data.limit, data.remaining și data.reset descriu bugetul pe minut al contului, nu creditele utilizabile. Obiectul data.quota descrie alocația lunară, soldurile de credite și utilizarea. Câmpurile existente data.monthly_limit, data.monthly_remaining și data.purchased_credits rămân aliasuri ale câmpurilor corespunzătoare din quota. Un control de stare reușit nu autorizează o altă operație API. Operațiile necesită în continuare acces activat, cotă disponibilă și admitere prin toate limitele aplicabile. Instantaneul de cotă nu promite capacitatea deja rezervată de o cerere în curs.
Verifică starea limitei de rată
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âmpuri de răspuns
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.

Protecție PIN pentru căsuța poștală

Introduceți PIN-ul pentru a continua. Cutia poștală rămâne deblocată în timp ce este activă în această sesiune a site-ului.

Acceptați cookie-uri?

Folosim cookie-uri pentru a-ți îmbunătăți experiența de navigare. Utilizând acest site, ești de acord cu politica noastră privind cookie-urile.

Mai mult