Hatari ya API ya TempMail

REST API v1 & Webhooks

TempMailg Nyaraka za API za Watengenezaji

Tumia hatari hii ili kuzalisha kibinafsi chenji cha API, uunganishe mwenyeji wa API wa mtumiaji, soma ujumbe wa sanduku la posta, usimamie masanduku ya posta yaliyomilikiwa, na uunganishe Temp Mail kwenye programu zako au utendakazi wa kiotomatiki.

Uthibitishaji wa Token ya Mlezi Webhooks za Wakati Halisi Majina ya utani ya Gmail & Outlook Majibu ya JSON
Msingi wa URL wa API wa Mtumiaji HTTPS
Muundo wa ombi Tumia kibinafsi chenji cha API chako tu katika kichwa cha uthibitishaji wa Bearer na uweke viunganishi vya mwisho vya URL kuwa safi.

Usimamizi wa kisanduku pokezi

Pata vikoa vilivyoruhusiwa, unda au badilisha sanduku la barua, chagua muda wa maisha ulioruhusiwa, na futa anwani zilizomilikiwa.

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

Orodha ya Vikoa Vilivyoruhusiwa

Orodhesha vikoa vinavyopatikana kwa ajili ya kuunda barua pepe za muda. Chuja kwa aina ili kuona vikoa vya bure, vya premium, au maalum vinavyoungwa mkono na mpango wako wa usajili.

Vigezo 1
Kigezo Mahali Aina Status Maelezo
type query string hiari
Kichujio cha ngazi ya kikoa. Uachaji hutumia yote wakati ufikiaji wa kikoa cha premium umewezeshwa, vinginevyo bure. Thamani zinazotambuliwa: free, basic, pro, premium, custom, ultimate, all
Chaguo-msingi: Inategemea akaunti
Pata madomini yanayoruhusiwa
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
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
            }
        ]
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
data.requested_type string
Kichujio cha kikoa kimewekwa.
data.plan string
Lebo ya mpango wa sasa.
data.plan_name string
Jina linaloweza kusomwa la mpango wa sasa.
data.allowed_types array<string>
Vichujio vya kikoa vinavyopatikana kwa akaunti hii. Kichujio kilichotambuliwa bado kinaweza kuondolewa kwa mpango wako.
data.domains array
Vikoa vinavyoweza kuchaguliwa baada ya kuchuja; safu tupu ni sahihi.
data.domains[].domain string
Jina la kikoa linaloweza kuchaguliwa.
data.domains[].type string
Lebo ya ngazi ya kikoa inayoweza kusomwa.
data.domains[].custom boolean
Iwapo hii ni kikoa maalum.
POST https://v1.tempmailg.com/api/emails
#

Unda Sanduku la Barua la Muda

Unda kisanduku pokezi cha muda kilicho na mmiliki. Achia jina la mtumiaji na kikoa kwa ajili ya uzalishaji wa nasibu, au toa jina la mtumiaji maalum lililoruhusiwa na kikoa kilichoruhusiwa. Kipengele cha mtoaji kinaweza kuchagua uzalishaji wa jina la utani la Gmail au Outlook.

Vigezo 8
Kigezo Mahali Aina Status Maelezo
username body string hiari
Jina la mtumiaji la desturi la hiari: herufi 2 hadi 64 za ASCII, nambari, nukta, underscore au dash. Inahitaji ruhusa ya mpango; custom_username pia inakubaliwa.
Chaguo-msingi: Imetengenezwa kwa nasibu
domain body string hiari
Moja ya vikoa vilivyoruhusiwa vinavyorudishwa na GET /domains. Ukosefu wa kuchagua huchagua kikoa kilichoruhusiwa kwa nasibu.
Chaguo-msingi: Kikoa cha nasibu kilichoruhusiwa
lifetime body string hiari
thamani zilizoruhusiwa:
10m — Muda wa dakika 10 1h — Miezi 1 2h — Mwaka wa Sita 1d — Siku moja 1w — Wiki moja 1m — Siku 30 3m — Mwaka Mmoja 6m — Mwaka Mrefu (180 Siku) 1y — Mwaka Mfululizo (365 Siku) unlimited — Zisizo na Kikomo
Chaguo-msingi: Muda wa maisha chaguo-msingi wa mpango
provider body string hiari
Mtoa huduma wa kisanduku pokezi: standard, gmail_alias, au outlook_alias.
Chaguo-msingi: standard
pin_enabled body boolean hiari
Ulinzi wa PIN wa hiari kwa kisanduku kipya, inapowezeshwa na mpango wako. Haufanyi mabadiliko kwenye PIN ya kisanduku kilichopo.
Chaguo-msingi: false
pin body string hiari
Inahitajika wakati pin_enabled ni true: PIN ya tarakimu 6 hadi 8, imetumwa kama string ili kuhifadhi sifuri za mwanzo.
pin_confirmation body string hiari
Inahitajika wakati pin_enabled ni kweli. Lazima ilingane kabisa na pin.
Idempotency-Key header string hiari
Inahitajika kwa uundaji au ufutaji uliolindwa na PIN: ufunguo thabiti wa herufi 16 hadi 128. Rudia ombi lile lile kwa ufunguo huo huo ili kuepuka kazi ya kurudia.
Vigezo vya mwili vya hiari: username (jina la mtumiaji maalum ikiwa kuruhusiwa na mpango), domain (kikoa kilichoruhusiwa, kwa mfano example.com), lifetime (thamani zilizoruhusiwa: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Ondoa muda wa maisha, au uache wazi, ili kutumia Muda wa Maisha wa Barua Pepe Chaguo-msingi uliosetiwa kwa mpango wako wa kila mwezi/kila mwaka wa sasa. Tuma muda wa maisha unaoruhusiwa kama 1h ili kubatilisha chaguo-msingi hicho. Isiyo na kikomo inatumika tu wakati imewekwa kama chaguo-msingi la mpango au imeombwa wazi na kuruhusiwa. Vigezo vya mwili mailbox_lifetime na email_lifetime pia vinakubaliwa; thamani ya kwanza isiyo tupu hushinda katika mpangilio huu: lifetime, mailbox_lifetime, email_lifetime. Thamani zisizo sahihi au zisizoruhusiwa hurudisha HTTP 422 badala ya kuchagua chaguo-msingi kimya.
Unda kisanduku pokezi
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2301,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-20T02:18:15+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:15+00:00",
        "email_token": "encrypted-email-token"
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
data.id integer
Kitambulisho cha sanduku la barua. Vitambulisho vilivyotengenezwa, anwani na tokeni hubadilika kwa kila sanduku la barua.
data.pin_protected boolean
Ikiwa kisanduku pokezi hiki kina ulinzi wa PIN. Hakuna PIN au hash ya PIN inayorudishwa.
data.email string
Anwani kamili ya kisanduku cha barua imeundwa.
data.domain string
Kikoa cha kisanduku pokezi kilichozalishwa.
data.provider string
Mtoa huduma wa kisanduku pokezi: standard, gmail_alias, au outlook_alias.
data.expire_at string|null
Muda wa kumalizika kama alama ya wakati ya ISO-8601, au null kwa kisanduku pokezi kisicho na kikomo.
data.expires_in_seconds number|null
Sekunde zisizo hasi zilizobaki wakati wa kuhesabu; sekunde za sehemu zinawezekana. Null inamaanisha isiyo na kikomo, si sifuri.
data.mailbox_state string
Hali ya kisanduku pokezi ya sasa: hai, imefungwa, imeisha, au haifanyi kazi.
data.receiving_enabled boolean
Je, kisanduku hiki cha barua kinapokea ujumbe unaokuja kwa sasa.
data.message_count integer
Idadi ya jumla ya ujumbe inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa sanduku la barua.
data.unread_message_count integer
Idadi ya ujumbe usiojifungua inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa kisanduku pokezi.
data.last_message_received_at string|null
Muda wa mwisho wa ujumbe uliopokelewa uliojulikana katika muundo wa ISO-8601, au null wakati haupatikani.
data.message_count_synced_at string|null
Muda wa usawazishaji wa idadi ya ujumbe wa mwisho katika muundo wa ISO-8601, au null kabla ya usawazishaji.
data.created_at string|null
Muda wa uundaji wa kisanduku pokezi katika muundo wa ISO-8601.
data.email_token string
Rejea ya kisanduku pokezi iliyosimbwa isiyoeleweka. Haiibadilishi uthibitishaji wa Bearer, ukaguzi wa umiliki, au idhini ya PIN.
data.pin_grant object
Sharti: uundaji wa sanduku la barua lililolindwa na PIN linaloendelea unarejesha ruhusa hii ya kusoma; uundaji wa kawaida usiolindwa unauacha.
data.pin_grant.mailbox_id integer
Kitambulisho cha kisanduku pokezi ambacho ruhusa ya kusoma ya masharti imeunganishwa.
data.pin_grant.unlock_token string
Token ya usomaji isiyoeleweka kwa X-Mailbox-Unlock yenye kitambulisho sawa cha mmiliki. Ike faragha na katika kumbukumbu; ruhusa ya usomaji haidhinishi ufutaji.
data.pin_grant.scope string
Upeo unaosomwa kwa ajili ya ruhusa ya uundaji wa masharti.
data.pin_grant.idle_timeout_seconds integer
Muda wa kupumzika unaoruhusiwa kwa ruhusa ya kusoma, kawaida sekunde 3600.
data.pin_grant.absolute_timeout_seconds integer
Muda wa maisha wa ruhusa ya kusoma, kawaida sekunde 86400.
data.pin_grant.expires_at string
Muda wa kumalizika wa ruhusa ya kusoma wa sasa katika muundo wa ISO-8601.
data.pin_grant.absolute_expires_at string
Muda wa kumalizika kamili wa ruhusa ya kusoma katika muundo wa ISO-8601. Mabadiliko ya usalama yanaweza kubatilisha ruhusa mapema.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Sasisha / Badilisha Sanduku la Barua

Unda au chagua kisanduku pokezi kwenye jina jipya la mtumiaji na kikoa baada ya kuthibitisha umiliki wa kisanduku pokezi cha sasa. Hii haibadilishi jina la kisanduku pokezi cha zamani wala haibadilishi muda wake wa maisha. Wakati marudio yanatofautiana, kisanduku pokezi cha zamani kinabaki katika historia na kinaweza kusitishwa na vikwazo vya kisanduku pokezi kilichopo. Kutumia tena marudio yako ya kilichopo kunarejesha muda uliotakiwa au chaguo-msingi la mpango.

Vigezo 9
Kigezo Mahali Aina Status Maelezo
email path string Inahitajika
Anwani kamili ya barua pepe ya kisanduku pokezi kilichomilikiwa kwa sasa ili kubadilisha. URL-encode kila sehemu ya njia; encode ishara ya kuongeza kama %2B.
username path string Inahitajika
Jina la mtumiaji jipya linalotakiwa: herufi na nambari 2 hadi 64; linategemea ruhusa ya jina la mtumiaji maalum.
domain path string Inahitajika
Jina jipya la kikoa linaloruhusiwa.
lifetime body string hiari
thamani zilizoruhusiwa:
10m — Muda wa dakika 10 1h — Miezi 1 2h — Mwaka wa Sita 1d — Siku moja 1w — Wiki moja 1m — Siku 30 3m — Mwaka Mmoja 6m — Mwaka Mrefu (180 Siku) 1y — Mwaka Mfululizo (365 Siku) unlimited — Zisizo na Kikomo
Chaguo-msingi: Muda wa maisha chaguo-msingi wa mpango
pin_enabled body boolean hiari
Ulinzi wa PIN wa hiari kwa kisanduku kipya, inapowezeshwa na mpango wako. Haufanyi mabadiliko kwenye PIN ya kisanduku kilichopo.
Chaguo-msingi: false
pin body string hiari
Inahitajika wakati pin_enabled ni true: PIN ya tarakimu 6 hadi 8, imetumwa kama string ili kuhifadhi sifuri za mwanzo.
pin_confirmation body string hiari
Inahitajika wakati pin_enabled ni kweli. Lazima ilingane kabisa na pin.
Idempotency-Key header string hiari
Inahitajika kwa uundaji au ufutaji uliolindwa na PIN: ufunguo thabiti wa herufi 16 hadi 128. Rudia ombi lile lile kwa ufunguo huo huo ili kuepuka kazi ya kurudia.
X-Mailbox-Unlock header string hiari
Kichwa, sanduku za barua zilizo salama pekee: tumia unlock_token ya kusoma. Kwanza POST pin na scope=read kwa URL ya kufungua PIN. Endelea kutumia uthibitishaji wako wa Bearer wa kawaida. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Tumia sanduku la posta lililonunuliwa lililopo la barua pepe katika {email}. Kipengele cha kimwili cha hiari: lifetime (thamani zinazoruhusiwa: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Ondoa muda wa maisha, au uache wazi, ili kutumia Muda wa Maisha wa Barua Pepe Chaguo-msingi uliosetiwa kwa mpango wako wa kila mwezi/kila mwaka wa sasa. Tuma muda wa maisha unaoruhusiwa kama 1h ili kubatilisha chaguo-msingi hicho. Isiyo na kikomo inatumika tu wakati imewekwa kama chaguo-msingi la mpango au imeombwa wazi na kuruhusiwa. Vigezo vya mwili mailbox_lifetime na email_lifetime pia vinakubaliwa; thamani ya kwanza isiyo tupu hushinda katika mpangilio huu: lifetime, mailbox_lifetime, email_lifetime. Thamani zisizo sahihi au zisizoruhusiwa hurudisha HTTP 422 badala ya kuchagua chaguo-msingi kimya.
Sasisha sanduku la posta lililonunuliwa
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'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2302,
        "pin_protected": false,
        "email": "demo123@example.com",
        "domain": "example.com",
        "provider": "standard",
        "expire_at": "2026-11-19T02:28:15+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:15+00:00",
        "email_token": "encrypted-email-token"
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
data.id integer
Kitambulisho cha sanduku la barua. Vitambulisho vilivyotengenezwa, anwani na tokeni hubadilika kwa kila sanduku la barua.
data.pin_protected boolean
Ikiwa kisanduku pokezi hiki kina ulinzi wa PIN. Hakuna PIN au hash ya PIN inayorudishwa.
data.email string
Anwani kamili ya kisanduku cha barua imeundwa.
data.domain string
Kikoa cha kisanduku pokezi kilichozalishwa.
data.provider string
Mtoa huduma wa kisanduku pokezi: standard, gmail_alias, au outlook_alias.
data.expire_at string|null
Muda wa kumalizika kama alama ya wakati ya ISO-8601, au null kwa kisanduku pokezi kisicho na kikomo.
data.expires_in_seconds number|null
Sekunde zisizo hasi zilizobaki wakati wa kuhesabu; sekunde za sehemu zinawezekana. Null inamaanisha isiyo na kikomo, si sifuri.
data.mailbox_state string
Hali ya kisanduku pokezi ya sasa: hai, imefungwa, imeisha, au haifanyi kazi.
data.receiving_enabled boolean
Je, kisanduku hiki cha barua kinapokea ujumbe unaokuja kwa sasa.
data.message_count integer
Idadi ya jumla ya ujumbe inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa sanduku la barua.
data.unread_message_count integer
Idadi ya ujumbe usiojifungua inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa kisanduku pokezi.
data.last_message_received_at string|null
Muda wa mwisho wa ujumbe uliopokelewa uliojulikana katika muundo wa ISO-8601, au null wakati haupatikani.
data.message_count_synced_at string|null
Muda wa usawazishaji wa idadi ya ujumbe wa mwisho katika muundo wa ISO-8601, au null kabla ya usawazishaji.
data.created_at string|null
Muda wa uundaji wa kisanduku pokezi katika muundo wa ISO-8601.
data.email_token string
Rejea ya kisanduku pokezi iliyosimbwa isiyoeleweka. Haiibadilishi uthibitishaji wa Bearer, ukaguzi wa umiliki, au idhini ya PIN.
data.pin_grant object
Sharti: uundaji wa sanduku la barua lililolindwa na PIN linaloendelea unarejesha ruhusa hii ya kusoma; uundaji wa kawaida usiolindwa unauacha.
data.pin_grant.mailbox_id integer
Kitambulisho cha kisanduku pokezi ambacho ruhusa ya kusoma ya masharti imeunganishwa.
data.pin_grant.unlock_token string
Token ya usomaji isiyoeleweka kwa X-Mailbox-Unlock yenye kitambulisho sawa cha mmiliki. Ike faragha na katika kumbukumbu; ruhusa ya usomaji haidhinishi ufutaji.
data.pin_grant.scope string
Upeo unaosomwa kwa ajili ya ruhusa ya uundaji wa masharti.
data.pin_grant.idle_timeout_seconds integer
Muda wa kupumzika unaoruhusiwa kwa ruhusa ya kusoma, kawaida sekunde 3600.
data.pin_grant.absolute_timeout_seconds integer
Muda wa maisha wa ruhusa ya kusoma, kawaida sekunde 86400.
data.pin_grant.expires_at string
Muda wa kumalizika wa ruhusa ya kusoma wa sasa katika muundo wa ISO-8601.
data.pin_grant.absolute_expires_at string
Muda wa kumalizika kamili wa ruhusa ya kusoma katika muundo wa ISO-8601. Mabadiliko ya usalama yanaweza kubatilisha ruhusa mapema.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Futa kisanduku pokezi

Futa kisanduku pokezi kilichomilikiwa na uanzishe usafi wa ujumbe na faili zake. Rekodi za kisanduku pokezi zilizohifadhiwa zinaweza kufutwa kwa upole ndani ya mfumo; anwani haitakweza tena kutumika kupitia API.

Vigezo 3
Kigezo Mahali Aina Status Maelezo
email path string Inahitajika
Anuani kamili ya barua pepe ya kisanduku kilichomilikiwa cha kufutwa. Fanya anwani kuwa URL-encoded; encode ishara ya kuongeza kama %2B.
X-Mailbox-Unlock header string hiari
Kichwa, sanduku la barua lililolindwa pekee: tumia unlock_token ya kufuta inayotumika mara moja. Kwanza POST pin, scope=delete na action/target_id iliyorudishwa na jibu la 423 kwa PIN unlock URL. Tokeni ya kusoma haiwezi kufuta. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string hiari
Inahitajika kwa uundaji au ufutaji uliolindwa na PIN: ufunguo thabiti wa herufi 16 hadi 128. Rudia ombi lile lile kwa ufunguo huo huo ili kuepuka kazi ya kurudia.
Futa sanduku la posta lililonunuliwa
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
message string
Matokeo ya ufutaji. Rasilimali isiyopatikana inarudisha HTTP 404.

Majina ya utani ya Gmail & Outlook

Tengeneza sanduku la barua pepe la bandia la Gmail na Outlook/Hotmail lenye sifa ya juu.

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

Unda jina bandia la Gmail

Unda kisanduku pokezi cha muda cha jina la utani la Gmail kilicho na mmiliki mtumiaji aliyethibitishwa.

Vigezo 8
Kigezo Mahali Aina Status Maelezo
mode body string hiari
Njia ya uzalishaji: auto, dot, plus, au plus_dot. Pia inakubali gmail_alias_mode. Ikiwa uteuzi wa mtindo hairuhusiwi, auto inatumika.
Chaguo-msingi: auto
username body string hiari
Kiambishi cha mwisho cha alias maalum cha hiari: herufi au nambari za ASCII 2 hadi 32, zimebadilishwa kuwa herufi ndogo; inategemea ruhusa ya kipengele. Pia inakubali custom_username au alias_username.
Chaguo-msingi: Imetengenezwa kiotomatiki
domain body string hiari
Tumia random, gmail.com au googlemail.com; alias_domain pia inakubaliwa. Ukosefu au ruhusa ya uteuzi wa kikoa isiyopatikana inatumia random.
Chaguo-msingi: random
lifetime body string hiari
thamani zilizoruhusiwa:
10m — Muda wa dakika 10 1h — Miezi 1 2h — Mwaka wa Sita 1d — Siku moja 1w — Wiki moja 1m — Siku 30 3m — Mwaka Mmoja 6m — Mwaka Mrefu (180 Siku) 1y — Mwaka Mfululizo (365 Siku) unlimited — Zisizo na Kikomo
Chaguo-msingi: Muda wa maisha chaguo-msingi wa mpango
pin_enabled body boolean hiari
Ulinzi wa PIN wa hiari kwa kisanduku kipya, inapowezeshwa na mpango wako. Haufanyi mabadiliko kwenye PIN ya kisanduku kilichopo.
Chaguo-msingi: false
pin body string hiari
Inahitajika wakati pin_enabled ni true: PIN ya tarakimu 6 hadi 8, imetumwa kama string ili kuhifadhi sifuri za mwanzo.
pin_confirmation body string hiari
Inahitajika wakati pin_enabled ni kweli. Lazima ilingane kabisa na pin.
Idempotency-Key header string hiari
Inahitajika kwa uundaji au ufutaji uliolindwa na PIN: ufunguo thabiti wa herufi 16 hadi 128. Rudia ombi lile lile kwa ufunguo huo huo ili kuepuka kazi ya kurudia.
Inahitaji ruhusa ya Gmail Alias API iwe imewezeshwa kwenye mpango wako wa usajili au ifunguliwe kupitia kifurushi cha API Credit. Vigezo vya hiari: mode (auto, dot, plus, plus_dot), username (jina la mtumiaji la bandia maalum), domain (e.g. gmail.com, googlemail.com), lifetime (thamani zilizoruhusiwa: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Ondoa muda wa maisha, au uache wazi, ili kutumia Muda wa Maisha wa Barua Pepe Chaguo-msingi uliosetiwa kwa mpango wako wa kila mwezi/kila mwaka wa sasa. Tuma muda wa maisha unaoruhusiwa kama 1h ili kubatilisha chaguo-msingi hicho. Isiyo na kikomo inatumika tu wakati imewekwa kama chaguo-msingi la mpango au imeombwa wazi na kuruhusiwa. Vigezo vya mwili mailbox_lifetime na email_lifetime pia vinakubaliwa; thamani ya kwanza isiyo tupu hushinda katika mpangilio huu: lifetime, mailbox_lifetime, email_lifetime. Thamani zisizo sahihi au zisizoruhusiwa hurudisha HTTP 422 badala ya kuchagua chaguo-msingi kimya.
Unda sanduku la barua la jina la utani la Gmail
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2305,
        "pin_protected": false,
        "email": "example+alias123@gmail.com",
        "domain": "gmail.com",
        "provider": "gmail_alias",
        "expire_at": "2026-11-19T03:18:15+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:15+00:00",
        "email_token": "encrypted-email-token"
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
data.id integer
Kitambulisho cha sanduku la barua. Vitambulisho vilivyotengenezwa, anwani na tokeni hubadilika kwa kila sanduku la barua.
data.pin_protected boolean
Ikiwa kisanduku pokezi hiki kina ulinzi wa PIN. Hakuna PIN au hash ya PIN inayorudishwa.
data.email string
Anwani kamili ya kisanduku cha barua imeundwa.
data.domain string
Kikoa cha kisanduku pokezi kilichozalishwa.
data.provider string
Mtoa huduma wa kisanduku pokezi: standard, gmail_alias, au outlook_alias.
data.expire_at string|null
Muda wa kumalizika kama alama ya wakati ya ISO-8601, au null kwa kisanduku pokezi kisicho na kikomo.
data.expires_in_seconds number|null
Sekunde zisizo hasi zilizobaki wakati wa kuhesabu; sekunde za sehemu zinawezekana. Null inamaanisha isiyo na kikomo, si sifuri.
data.mailbox_state string
Hali ya kisanduku pokezi ya sasa: hai, imefungwa, imeisha, au haifanyi kazi.
data.receiving_enabled boolean
Je, kisanduku hiki cha barua kinapokea ujumbe unaokuja kwa sasa.
data.message_count integer
Idadi ya jumla ya ujumbe inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa sanduku la barua.
data.unread_message_count integer
Idadi ya ujumbe usiojifungua inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa kisanduku pokezi.
data.last_message_received_at string|null
Muda wa mwisho wa ujumbe uliopokelewa uliojulikana katika muundo wa ISO-8601, au null wakati haupatikani.
data.message_count_synced_at string|null
Muda wa usawazishaji wa idadi ya ujumbe wa mwisho katika muundo wa ISO-8601, au null kabla ya usawazishaji.
data.created_at string|null
Muda wa uundaji wa kisanduku pokezi katika muundo wa ISO-8601.
data.email_token string
Rejea ya kisanduku pokezi iliyosimbwa isiyoeleweka. Haiibadilishi uthibitishaji wa Bearer, ukaguzi wa umiliki, au idhini ya PIN.
data.pin_grant object
Sharti: uundaji wa sanduku la barua lililolindwa na PIN linaloendelea unarejesha ruhusa hii ya kusoma; uundaji wa kawaida usiolindwa unauacha.
data.pin_grant.mailbox_id integer
Kitambulisho cha kisanduku pokezi ambacho ruhusa ya kusoma ya masharti imeunganishwa.
data.pin_grant.unlock_token string
Token ya usomaji isiyoeleweka kwa X-Mailbox-Unlock yenye kitambulisho sawa cha mmiliki. Ike faragha na katika kumbukumbu; ruhusa ya usomaji haidhinishi ufutaji.
data.pin_grant.scope string
Upeo unaosomwa kwa ajili ya ruhusa ya uundaji wa masharti.
data.pin_grant.idle_timeout_seconds integer
Muda wa kupumzika unaoruhusiwa kwa ruhusa ya kusoma, kawaida sekunde 3600.
data.pin_grant.absolute_timeout_seconds integer
Muda wa maisha wa ruhusa ya kusoma, kawaida sekunde 86400.
data.pin_grant.expires_at string
Muda wa kumalizika wa ruhusa ya kusoma wa sasa katika muundo wa ISO-8601.
data.pin_grant.absolute_expires_at string
Muda wa kumalizika kamili wa ruhusa ya kusoma katika muundo wa ISO-8601. Mabadiliko ya usalama yanaweza kubatilisha ruhusa mapema.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Majina ya Kijina ya Outlook

Pata vikoa vya alias vya Outlook / Hotmail vinavyopatikana kwa ajili ya uundaji wa kisanduku pokezi.

Inahitaji ruhusa ya Outlook Alias API iwe imewezeshwa kwenye mpango wako wa usajili au ifunguliwe kupitia kifurushi cha Mikopo ya API. Inaonyesha ikiwa uteuzi wa kikoa maalum umefunguliwa kwenye mpango wako.
Pata vikoa vya jina la utani la Outlook
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
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
            }
        ]
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
data.domains array
Vikoa vya Outlook/Hotmail vinavyofanya kazi; safu tupu ni sahihi.
data.domains[].domain string
Jina la kikoa linalopatikana.
data.domains[].type string
Lebo ya mtoa huduma inayoweza kusomwa.
data.domains[].selectable boolean
Ikiwa akaunti yako inaweza kuchagua waziwazi kikoa hiki.
data.domains[].locked boolean
Je, uchaguzi wa kikoa wazi umefungwa kwa akaunti yako.
data.domains[].disabled_reason string|null
Sababu ya uteuzi wa kikoa umefungwa, au null wakati unaweza kuchagua.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Unda Alias ya Outlook

Unda kisanduku pokezi cha muda cha alias ya Outlook / Hotmail kilicho na mmiliki mtumiaji aliyethibitishwa.

Vigezo 7
Kigezo Mahali Aina Status Maelezo
domain body string hiari
Tumia nasibu au kikoa kutoka GET /outlook-alias/domains; outlook_alias_domain pia inakubaliwa. Bila ruhusa ya uchaguzi, nasibu inatumiwa.
Chaguo-msingi: Kikoa kinachopatikana cha nasibu
username body string hiari
Kiambishi cha mwisho cha alias maalum cha hiari: herufi au nambari za ASCII 2 hadi 32, zimebadilishwa kuwa herufi ndogo; inategemea ruhusa ya kipengele. Pia inakubali custom_username au alias_username.
Chaguo-msingi: Imetengenezwa kiotomatiki
lifetime body string hiari
thamani zilizoruhusiwa:
10m — Muda wa dakika 10 1h — Miezi 1 2h — Mwaka wa Sita 1d — Siku moja 1w — Wiki moja 1m — Siku 30 3m — Mwaka Mmoja 6m — Mwaka Mrefu (180 Siku) 1y — Mwaka Mfululizo (365 Siku) unlimited — Zisizo na Kikomo
Chaguo-msingi: Muda wa maisha chaguo-msingi wa mpango
pin_enabled body boolean hiari
Ulinzi wa PIN wa hiari kwa kisanduku kipya, inapowezeshwa na mpango wako. Haufanyi mabadiliko kwenye PIN ya kisanduku kilichopo.
Chaguo-msingi: false
pin body string hiari
Inahitajika wakati pin_enabled ni true: PIN ya tarakimu 6 hadi 8, imetumwa kama string ili kuhifadhi sifuri za mwanzo.
pin_confirmation body string hiari
Inahitajika wakati pin_enabled ni kweli. Lazima ilingane kabisa na pin.
Idempotency-Key header string hiari
Inahitajika kwa uundaji au ufutaji uliolindwa na PIN: ufunguo thabiti wa herufi 16 hadi 128. Rudia ombi lile lile kwa ufunguo huo huo ili kuepuka kazi ya kurudia.
Inahitaji ruhusa ya Outlook Alias API iwe imewezeshwa kwenye mpango wako wa usajili au ifunguliwe kupitia kifurushi cha Mikopo ya API. Vigezo vya hiari: domain (kwa mfano outlook.com, hotmail.com), username (jina la mtumiaji la bandia maalum), lifetime (thamani zilizoruhusiwa: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Ondoa muda wa maisha, au uache wazi, ili kutumia Muda wa Maisha wa Barua Pepe Chaguo-msingi uliosetiwa kwa mpango wako wa kila mwezi/kila mwaka wa sasa. Tuma muda wa maisha unaoruhusiwa kama 1h ili kubatilisha chaguo-msingi hicho. Isiyo na kikomo inatumika tu wakati imewekwa kama chaguo-msingi la mpango au imeombwa wazi na kuruhusiwa. Vigezo vya mwili mailbox_lifetime na email_lifetime pia vinakubaliwa; thamani ya kwanza isiyo tupu hushinda katika mpangilio huu: lifetime, mailbox_lifetime, email_lifetime. Thamani zisizo sahihi au zisizoruhusiwa hurudisha HTTP 422 badala ya kuchagua chaguo-msingi kimya.
Unda kisanduku pokezi la jina la utendaji la Outlook
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "data": {
        "id": 2306,
        "pin_protected": false,
        "email": "example+alias45@outlook.com",
        "domain": "outlook.com",
        "provider": "outlook_alias",
        "expire_at": "2026-11-19T03:18:15+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:18:15+00:00",
        "email_token": "encrypted-email-token"
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
data.id integer
Kitambulisho cha sanduku la barua. Vitambulisho vilivyotengenezwa, anwani na tokeni hubadilika kwa kila sanduku la barua.
data.pin_protected boolean
Ikiwa kisanduku pokezi hiki kina ulinzi wa PIN. Hakuna PIN au hash ya PIN inayorudishwa.
data.email string
Anwani kamili ya kisanduku cha barua imeundwa.
data.domain string
Kikoa cha kisanduku pokezi kilichozalishwa.
data.provider string
Mtoa huduma wa kisanduku pokezi: standard, gmail_alias, au outlook_alias.
data.expire_at string|null
Muda wa kumalizika kama alama ya wakati ya ISO-8601, au null kwa kisanduku pokezi kisicho na kikomo.
data.expires_in_seconds number|null
Sekunde zisizo hasi zilizobaki wakati wa kuhesabu; sekunde za sehemu zinawezekana. Null inamaanisha isiyo na kikomo, si sifuri.
data.mailbox_state string
Hali ya kisanduku pokezi ya sasa: hai, imefungwa, imeisha, au haifanyi kazi.
data.receiving_enabled boolean
Je, kisanduku hiki cha barua kinapokea ujumbe unaokuja kwa sasa.
data.message_count integer
Idadi ya jumla ya ujumbe inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa sanduku la barua.
data.unread_message_count integer
Idadi ya ujumbe usiojifungua inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa kisanduku pokezi.
data.last_message_received_at string|null
Muda wa mwisho wa ujumbe uliopokelewa uliojulikana katika muundo wa ISO-8601, au null wakati haupatikani.
data.message_count_synced_at string|null
Muda wa usawazishaji wa idadi ya ujumbe wa mwisho katika muundo wa ISO-8601, au null kabla ya usawazishaji.
data.created_at string|null
Muda wa uundaji wa kisanduku pokezi katika muundo wa ISO-8601.
data.email_token string
Rejea ya kisanduku pokezi iliyosimbwa isiyoeleweka. Haiibadilishi uthibitishaji wa Bearer, ukaguzi wa umiliki, au idhini ya PIN.
data.pin_grant object
Sharti: uundaji wa sanduku la barua lililolindwa na PIN linaloendelea unarejesha ruhusa hii ya kusoma; uundaji wa kawaida usiolindwa unauacha.
data.pin_grant.mailbox_id integer
Kitambulisho cha kisanduku pokezi ambacho ruhusa ya kusoma ya masharti imeunganishwa.
data.pin_grant.unlock_token string
Token ya usomaji isiyoeleweka kwa X-Mailbox-Unlock yenye kitambulisho sawa cha mmiliki. Ike faragha na katika kumbukumbu; ruhusa ya usomaji haidhinishi ufutaji.
data.pin_grant.scope string
Upeo unaosomwa kwa ajili ya ruhusa ya uundaji wa masharti.
data.pin_grant.idle_timeout_seconds integer
Muda wa kupumzika unaoruhusiwa kwa ruhusa ya kusoma, kawaida sekunde 3600.
data.pin_grant.absolute_timeout_seconds integer
Muda wa maisha wa ruhusa ya kusoma, kawaida sekunde 86400.
data.pin_grant.expires_at string
Muda wa kumalizika wa ruhusa ya kusoma wa sasa katika muundo wa ISO-8601.
data.pin_grant.absolute_expires_at string
Muda wa kumalizika kamili wa ruhusa ya kusoma katika muundo wa ISO-8601. Mabadiliko ya usalama yanaweza kubatilisha ruhusa mapema.

Ujumbe & Viambatisho

Pata visanduku vya barua vinavyokuja, soma ujumbe kamili wa HTML/maandishi, na mtiririko wa viambatisho.

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

Orodhesha Ujumbe wa Kisanduku Pokezi

Pata muhtasari wa ujumbe unaopatikana na metadata ya kisanduku pokezi. Uchakataji wa kawaida wa kisanduku pokezi hurudisha kundi la hivi karibuni la hadi ujumbe 25; hii si kiunganishi cha kurasa kamili kilichopangwa. Tumia GET /messages/{messageId} kwa miili kamili na viambatisho.

Vigezo 2
Kigezo Mahali Aina Status Maelezo
email query string Inahitajika
Anwani kamili ya barua pepe ya kisanduku pokezi kilichomilikiwa ili kusoma ujumbe kutoka. URL-encode thamani ya swali; encode ishara ya kuongeza kama %2B.
X-Mailbox-Unlock header string hiari
Kichwa, sanduku za barua zilizo salama pekee: tumia unlock_token ya kusoma. Kwanza POST pin na scope=read kwa URL ya kufungua PIN. Endelea kutumia uthibitishaji wako wa Bearer wa kawaida. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Barua pepe lazima iwe ya akaunti yako. Muhtasari wa kawaida na wa Gmail yana sehemu za OTP na kiungo cha uthibitishaji; Outlook pia inajumuisha from_name, snippet, received_at na has_attachments. Usawazishaji wa mtoa huduma na uhifadhi wa muda mfupi unaweza kuchelewesha ujumbe mpya na hesabu.
Soma ujumbe wa sanduku la posta
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'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "mailbox": "demo123@example.com",
    "email_token": "encrypted-email-token",
    "messages": [
        {
            "is_seen": false,
            "subject": "Welcome to Temp Mail",
            "from": "Example Sender",
            "from_email": "hello@example.org",
            "receivedAt": "2026-11-19 02:18:15",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:18:15+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:18:15+00:00",
    "message_count_synced_at": "2026-11-19T02:18:15+00:00"
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
mailbox string
Anwani ya kisanduku pokezi ambayo ujumbe wake ulitakiwa.
email_token string
Rejea ya kisanduku pokezi iliyosimbwa isiyoeleweka; uthibitishaji wa kawaida bado unahitajika.
mailbox_provider string
Mtoa huduma wa kisanduku pokezi: standard, gmail_alias, au outlook_alias.
messages array
Muhtasari wa ujumbe. Kifaa kisicho na barua za kuingia kinarejesha safu tupu; pata ujumbe mmoja kwa mwili wake na viambatisho.
expire_at string|null
Muda wa kumalizika kama alama ya wakati ya ISO-8601, au null kwa kisanduku pokezi kisicho na kikomo.
expires_in_seconds number|null
Sekunde zisizo hasi zilizobaki wakati wa kuhesabu; sekunde za sehemu zinawezekana. Null inamaanisha isiyo na kikomo, si sifuri.
mailbox_state string
Hali ya kisanduku pokezi ya sasa: hai, imefungwa, imeisha, au haifanyi kazi.
receiving_enabled boolean
Je, kisanduku hiki cha barua kinapokea ujumbe unaokuja kwa sasa.
message_count integer
Idadi ya jumla ya ujumbe inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa sanduku la barua.
unread_message_count integer
Idadi ya ujumbe usiojifungua inayojulikana; inaweza kuakisi usawazishaji wa mwisho wa kisanduku pokezi.
last_message_received_at string|null
Muda wa mwisho wa ujumbe uliopokelewa uliojulikana katika muundo wa ISO-8601, au null wakati haupatikani.
message_count_synced_at string|null
Muda wa usawazishaji wa idadi ya ujumbe wa mwisho katika muundo wa ISO-8601, au null kabla ya usawazishaji.
mailbox_limit.limit integer
Kikomo cha kisanduku pokezi kilichowashwa kwa mtoa huduma huyu; -1 ina maana ya isiyo na kikomo.
mailbox_limit.limit_label string
Lebo ya kuonyesha kwa kikomo cha kisanduku pokezi.
mailbox_limit.active_count integer
Idadi ya sanduku la barua pepe linaloendelea kwa mtoa huduma huyu.
mailbox_limit.paused_count integer
Idadi ya sanduku za barua zilizosimamishwa kwa mtoa huduma huyu.
mailbox_limit.paused_mailboxes array<string>
Anwani zimezimwa kwa kikomo cha kisanduku pokezi.
mailbox_limit.remaining integer
Nafasi zilizobaki za kisanduku pokezi vinavyofanya kazi; -1 ina maana ya isiyo na kikomo. Hii si kiasi cha maombi ya API.
mailbox_limit.remaining_label string
Onyesha lebo ya nafasi zilizobaki za sanduku la barua.
mailbox_limit.reached boolean
Ikiwa kikomo cha kisanduku pokezi kilichopo kimefikiwa.
mailbox_limit.blocked boolean
Je, kikomo cha kisanduku pokezi kilichofanya kazi ni sifuri.
mailbox_limit.provider string|null
Mtoa huduma ambako kikomo cha sanduku la barua kinahusishwa.
messages[].id string
Kitambulisho cha ujumbe kisicho wazi kinachotumika na sehemu za ujumbe mmoja, ufutaji, na kiambatisho.
messages[].is_seen boolean
Iwapo ujumbe umewekwa alama ya kusomwa.
messages[].subject string
Mada ya ujumbe.
messages[].from string
Jina la kuonyesha la mtumaji au anwani.
messages[].from_email string
Anwani ya barua pepe ya mtumaji.
messages[].receivedAt string
Muda ulipokelewa katika saa ya programu, umepangwa kama YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Imetambua msimbo wa mara moja wakati upo na kuruhusiwa; vinginevyo ni null.
messages[].otp_locked boolean
Ikiwa msimbo wa mara moja uliogunduliwa umefichwa na ruhusa za kipengele.
messages[].verification_link string|null
Uliogunduliwa URL ya uthibitishaji inapopatikana na kuruhusiwa; vinginevyo ni null.
messages[].verification_link_locked boolean
Ikiwa kiungo cha uthibitishaji kilichogunduliwa kimefichwa na ruhusa za kipengele.
messages[].from_name string|null
Sehemu ya muhtasari wa Outlook: jina la mtumaji asili. Haipo katika muhtasari wa Standard na Gmail.
messages[].snippet string|null
Sehemu ya muhtasari ya Outlook: hakiki fupi wa ujumbe.
messages[].received_at string|null
Sehemu ya muhtasari wa Outlook: muda ulipokelewa wa ISO-8601, inapojulikana.
messages[].has_attachments boolean
Sehemu ya muhtasari ya Outlook: ikiwa metadata ya kiambatisho ipo. Upatikanaji wa upakuaji hukaguliwa tofauti.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Pata Ujumbe Mmoja

Pata ujumbe ulio na miliki kwa kutumia kitambulisho chake cha ujumbe kisichoeleweka. Hurejesha muundo wa mwili na metadata ya kiambatisho. Sehemu za mwili zinategemea muundo wa ujumbe; Outlook inaongeza sehemu maalum za mtoa huduma zilizo hapa chini.

Vigezo 2
Kigezo Mahali Aina Status Maelezo
messageId path string Inahitajika
Kitambulisho cha kipekee cha ujumbe kinachorudishwa katika orodha ya ujumbe.
X-Mailbox-Unlock header string hiari
Kichwa, sanduku za barua zilizo salama pekee: tumia unlock_token ya kusoma. Kwanza POST pin na scope=read kwa URL ya kufungua PIN. Endelea kutumia uthibitishaji wako wa Bearer wa kawaida. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Soma ujumbe mmoja
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "data": {
        "is_seen": true,
        "subject": "Welcome to Temp Mail",
        "from": "Example Sender",
        "from_email": "hello@example.org",
        "to": "demo123@example.com",
        "mailbox_provider": "standard",
        "receivedAt": "2026-11-19 02:18:15",
        "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"
            }
        ]
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
data.id string
Kitambulisho cha ujumbe kisichoonekana.
data.is_seen boolean
Hali ya kusoma ujumbe. Kusoma kunaweza kuashiria kuwa imeonekana; data iliyohifadhiwa kwenye cache inaweza kuonyesha hali ya awali.
data.subject string
Mada ya ujumbe.
data.from string
Jina la kuonyesha la mtumaji au anwani.
data.from_email string
Anwani ya barua pepe ya mtumaji.
data.to string
Anwani ya sanduku la barua la mpokeaji.
data.mailbox_provider string
Mtoa huduma wa kisanduku pokezi: standard, gmail_alias, au outlook_alias.
data.receivedAt string
Muda ulipokelewa katika saa ya programu, umepangwa kama YYYY-MM-DD HH:mm:ss.
data.html boolean
Ikiwa ujumbe una mwili wa HTML.
data.html_content string
Mwili wa HTML unapopatikana. Ujumbe wa kawaida usio na HTML unaweza kuachwa uga huu. Chukulia maudhui ya ujumbe kama yasiyoaminika.
data.text_content string
Mwandiko wa maandishi unapopatikana; Ujumbe wa kawaida unaweza kuwa na maandishi yaliyokwekwa alama katika kipengele cha pre au kuachana na uga huu.
data.content string
Mwili unaopendekezwa kwa ajili ya kuonyesha, kawaida HTML inapopatikana.
data.attachments array
Metadata ya kiambatisho, au safu tupu. Upakuaji unahitaji uthibitishaji wa kawaida na idhini ya PIN inayotumika.
data.attachments[].name string
Jina la faili la ku-URL-encode kama kipande kimoja cha njia wakati wa kupakua.
data.attachments[].size integer
Ukubwa wa kiambatisho kwa bajti.
data.attachments[].url string
URL ya upakuaji ya API ya Mtumiaji Aliyetambulishwa imeongezwa kwa viambatisho na jina la faili. URL haidhihirishi kuwa faili ya ndani inapatikana.
data.attachments[].extension string
Sehemu ya metadata ya Kawaida/Gmail: kiendelezo cha faili kinapowekwa.
data.attachments[].id string
Sehemu ya metadata ya Outlook: kitambulisho cha kiambatisho cha mtoa huduma.
data.attachments[].content_type string
Sehemu ya metadata ya Outlook: aina ya maudhui ya MIME.
data.from_name string|null
Sehemu ya maelezo ya Outlook: jina la mtumaji wa awali.
data.to_email string|null
Sehemu ya maelezo ya Outlook: anwani ya mpokeaji wa awali.
data.received_at string|null
Sehemu ya maelezo ya Outlook: muda ulipokelewa wa ISO-8601.
data.has_html boolean
Sehemu ya maelezo ya Outlook: ikiwa mwili wa HTML upo.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Ta bort meddelande

Futa ujumbe mmoja ulionunuliwa

Vigezo 3
Kigezo Mahali Aina Status Maelezo
messageId path string Inahitajika
Mfuatano wa kitambulisho cha ujumbe wa kipekee wa kufuta kabisa.
X-Mailbox-Unlock header string hiari
Kichwa, sanduku la barua lililolindwa pekee: tumia unlock_token ya kufuta inayotumika mara moja. Kwanza POST pin, scope=delete na action/target_id iliyorudishwa na jibu la 423 kwa PIN unlock URL. Tokeni ya kusoma haiwezi kufuta. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string hiari
Inahitajika kwa uundaji au ufutaji uliolindwa na PIN: ufunguo thabiti wa herufi 16 hadi 128. Rudia ombi lile lile kwa ufunguo huo huo ili kuepuka kazi ya kurudia.
Ondoa ujumbe mmoja
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Sehemu za majibu
Uwanja Aina Maelezo
status boolean
Je, operesheni ilifanikiwa?
message string
Matokeo ya ufutaji. Rasilimali isiyopatikana inarudisha HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Pakua Kiambatisho

Piga chapa kwa nyongeza kutoka kwa ujumbe uliomilikiwa.

Vigezo 3
Kigezo Mahali Aina Status Maelezo
messageId path string Inahitajika
ID ya ujumbe unaojumuisha faili.
filename path string Inahitajika
Jina la faili na kiendelezi cha kiambatisho cha kupakuliwa.
X-Mailbox-Unlock header string hiari
Kichwa, sanduku za barua zilizo salama pekee: tumia unlock_token ya kusoma. Kwanza POST pin na scope=read kwa URL ya kufungua PIN. Endelea kutumia uthibitishaji wako wa Bearer wa kawaida. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Mafanikio hurudisha baiti za faili, si JSON. Faili kubwa sana hurudisha HTTP 403; faili zilizokosekana au zisizopatikana za ndani hurudisha HTTP 404. URL-encode jina la faili kama kipande kimoja cha njia. Metadata ya kiambatisho pekee haihakikishi upatikanaji wa upakuaji.
Piga chapa kwa nyongeza
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
Tabia ya kushusha Nukta hii inarudisha faili inayohitajika moja kwa moja badala ya mwili wa JSON.
Sehemu za majibu
Uwanja Aina Maelezo
Content-Disposition header
Jibu la mafanikio hupakua jina la faili lililotakiwa.
body binary
Baiti za faili wakati wa mafanikio, si JSON. Makosa hurudisha JSON na hali isiyo ya 2xx.

Vikomo vya Kiwango na Kikomo

Fuatilia bajeti za maombi ya wakati halisi, viwango vya kiwango, na quota za akaunti bila kutumia mikopo.

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

Kikomo cha Kiwango na Saida

Angalia kikomo chako cha kiwango cha sasa na hali ya kiasi bila kutumia matumizi yoyote ya API. Sehemu hii ya mwisho haina kikomo cha kiasi na haiondoi mikopo ya API ya kila mwezi (kikomo cha ulinzi dhidi ya matumizi mabaya: 60 requests/min).

X-RateLimit-* inaelezea bajeti ya ombi iliyoonyeshwa; X-Quota-* inaelezea uwezo wa kila mwezi na uliununuwa inapopatikana. X-Mailbox-RateLimit-* inaripoti bajeti tofauti ya uundaji/usushe wa kisanduku pokezi. Kukataliwa kwa kisanduku pokezi pekee kunatumia wigo wa kisanduku pokezi na dirisha lake la kujaribu tena. Kukataliwa kwa kipimo cha dakika kunaweza kuachwa taarifa ya quota. Retry-After imejumuishwa tu kwa jaribio la muda; upatikanaji uliozimwa unaweza kuhitaji mabadiliko ya akaunti. Katika jibu hili la hali yenye mafanikio, data.limit, data.remaining na data.reset zinaelezea bajeti ya dakika ya akaunti, si mikopo inayoweza kutumika. Kitu cha data.quota kinaelezea idhini ya kila mwezi, salio la mikopo na matumizi. Sehemu zilizopo data.monthly_limit, data.monthly_remaining na data.purchased_credits bado ni majina mbadala ya sehemu zinazolingana za quota. Ukaguzi wa hali uliofanikiwa haukuiwezeshi operesheni nyingine ya API. Operesheni bado zinahitaji ufikiaji uliowezeshwa, kiasi kinachopatikana, na idhini kupitia vikwazo vyote vinavyotumika. Picha ya kiasi haiahidi uwezo ambao tayari umehifadhiwa na ombi linaloendelea.
Angalia hali ya kikomo cha kiwango
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Jibu la mfano likitumia data ya bandia. Vitambulisho, anwani, tokeni, alama za wakati, mipaka ya mpango na hesabu hubadilika. Muda wa sampuli hauzidi chaguo-msingi cha mpango wako. Maelezo ya sehemu za jibu yanabainisha sehemu zinazoweza kuwa null na sehemu maalum za mtoa huduma.

Mfano wa jibu
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"
        }
    }
}
Sehemu za majibu
Uwanja Aina Maelezo
data.limit integer|string
Kikomo cha maombi kwa dakika ya akaunti. Kamba unlimited inaashiria bajeti ya dakika isiyo na kikomo; hii haitegemei kiasi cha mwezi.
data.remaining integer|string
Nafasi za bajeti ya dakika zilizobaki za akaunti, au kamba unlimited. Thamani chanya haimaanishi kwamba mikopo ya API inabaki.
data.reset integer
Sekunde kwa dirisha la dakika la akaunti, si kwa urejeshaji wa kiasi cha mwezi. Bajeti za dakika zilizozimwa au zisizo na kikomo zinaweza kudumisha thamani ya sekunde 60 ya kawaida; hii haiahidi upatikanaji baada ya kusubiri.
data.plan string
Tagi ya mpango wa sasa. Jina la mpango linaloweza kusomwa linatolewa kando katika data.quota.plan_name.
data.quota.enabled boolean
Ikiwa ufikiaji wa API ya kimataifa na wa mpango/kredi umewezeshwa. Hii haionyeshi uwezo uliobaki wala haibadilishi swichi ya API ya mtumiaji.
data.quota.user_api_status boolean
Ikiwa mtumiaji amewasha swichi ya API ya Mtumiaji. Operesheni zinahitaji swichi hii pamoja na ufikiaji uliowezeshwa na uwezo unaopatikana.
data.quota.plan_name string
Jina linaloweza kusomwa la mpango wa sasa.
data.quota.period string
Kipindi cha matumizi cha kalenda-mwezi katika muundo wa YYYY-MM, ukitumia saa ya programu; si lazima kipindi cha malipo cha usajili.
data.quota.base_limit integer
Kikomo cha msingi cha mpango wa kila mwezi. Thamani ya -1 ina maana ya isiyo na kikomo.
data.quota.extra_requests integer
Ruhusa ya ziada ya kila mwezi imetolewa kwa kipindi cha matumizi cha sasa; tofauti na mikopo iliyonunuliwa.
data.quota.monthly_limit integer
Ruhusa ya msingi pamoja na maombi ya ziada ya kipindi cha sasa. Thamani ya -1 ina maana ya isiyo na kikomo. Salio lililonunuliwa halijumuishi.
data.quota.monthly_remaining integer|null
Kiasi kilichobaki cha kipimo cha mwezi kilichopatikana, au null wakati kiasi cha mwezi hakina kikomo. Null haipaswi kutafsiriwa kama sifuri.
data.quota.used integer
Mafanikio, hesabu ya shughuli za API katika kipindi cha matumizi cha sasa, ikijumuisha shughuli zinazotumia mikopo. Ukaguzi wa hali hauongeza thamani hii.
data.quota.purchased_credits integer
Salio la mkopo wa sasa, likijumuisha mikopo ya ziada ya mpango unaofanya kazi. Mikopo ya ziada haipaswi kuongezwa kwenye salio hili tena.
data.quota.bonus_credits integer
Sehemu ya bonasi ya mpango inayofanya kazi ya salio la mkopo; mgawanyo wa purchased_credits, si uwezo wa ziada.
data.quota.direct_purchased_credits integer
Salio la mkopo isipokuwa sehemu ya bonasi ya mpango inayofanya kazi. Thamani hii pamoja na bonus_credits inalingana na purchased_credits.
data.quota.remaining integer|null
Kiasi kilichobaki cha kila mwezi pamoja na salio la mkopo wa sasa, bila kuhesabu bonasi mara mbili. Null inamaanisha quota isiyo na kikomo kwa mwezi. Ruhusa za kipengele binafsi na vikwazo vingine vya maombi bado vinatumika.
data.quota.unlimited boolean
Ikiwa kiasi cha kila mwezi ni isiyo na kikomo. Hii haifanya bajeti ya dakika ya akaunti au vikwazo vingine vya kipengele kuwa isiyo na kikomo.
data.quota.usage_percent integer
Asilimia iliyokunjwa inayolingana na dashibodi kutoka 0 hadi 100: iliyotumika imegawanywa kwa iliyotumika pamoja na iliyobaki, ikizidishwa kwa 100. Inajumuisha uwezo wa mkopo unaopatikana, hivyo kuchaji tena kunaweza kupunguza asilimia. Ni 0 kwa quota isiyo na kikomo au bwawa usio na ukubwa; si asilimia ya kiwango cha dakika au uamuzi wa ufikiaji.
data.quota.reset_at string
Muda wa alama ya ISO-8601 na tofauti ya ukanda wa saa kwa ajili ya urejeshaji wa kiasi cha mwezi ujao wa kalenda. Hii si tarehe ya kumaliza usajili, na urejeshaji wa kila mwezi haujajaza tena mikopo iliyonunuliwa.
status string
Mafanikio halisi kwa kipengele hiki cha hali. Vituo vingine vya sanduku la barua vinavyofanikiwa hutumia boolean true.
data.monthly_limit integer
Jina la utendaji wa ulinganifu la uga unaolingana wa data.quota; usiliongeze tena wakati wa kuhesabu salio.
data.monthly_remaining integer|null
Jina la utendaji wa ulinganifu la uga unaolingana wa data.quota; usiliongeze tena wakati wa kuhesabu salio.
data.purchased_credits integer
Jina la utendaji wa ulinganifu la uga unaolingana wa data.quota; usiliongeze tena wakati wa kuhesabu salio.

Ulinzi wa PIN ya kisanduku pokezi

Ingiza PIN ili kuendelea. Sanduku lako la barua linabaki kimefunguliwa wakati linaendelea katika kikao hiki cha tovuti.

Godkänner du kakor?

Vi använder cookies för att förbättra din webbläsarupplevelse. Genom att använda denna webbplats samtycker du till vår cookiepolicy.

Mer