Caibidhneacht API TempMail

REST API v1 & Webhooks

TempMailg Doiciméid API Forbróra

Úsáid an doiciméad taighde seo chun do eochair API pearsanta a ghiniúint, ceangal óstach API úsáideora, teachtaireachtaí bosca poist a léamh, boscaí poist úinéir a bhainistiú, agus Temp Mail a chur in oiriúint do do chuid aip nó uathoibrithe féin

Fíordheimhniú Token Bearer Webhooks Fíor-ama Gmail & Outlook Aliasanna Freagraí JSON
Bun-URL API Úsáideora HTTPS
Formáid iarratais Úsáid a dhéanamh de do eochair API i gcéad cheannachú údarás Bearer agus url deireadh a choimeád glan

Bainistíocht Bosca Poist

Faigh fearainn ceadaithe, cruthaigh nó athraigh boscaí poist, roghnaigh tréimhsí ceadaithe, agus scrios seoltaí úinéireachta.

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

Liosta na nDomhain Ceadaithe

Liostáil na fearainn atá ar fáil chun ríomhphoist shealadacha a chruthú. Scag de réir chineáil chun féachaint ar na fearainn saor, préimhe, nó saincheaptha a thacaíonn le do phlean síntiúis.

Paraiméadair 1
Paraiméadar Suíomh Sorc Stádas Cur Síos
type query string roghnach
Scagaire sraithe fearainn. Úsáidtear gach ceann nuair atá rochtain fearainn phréime cumasaithe, nó saor. Luachanna aitheanta: free, basic, pro, premium, custom, ultimate, all
Réamhshocrú: Spleách ar chuntas
Faigh forbhreathnú ceadaithe
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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
            }
        ]
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
data.requested_type string
Scagaire fearainn curtha i bhfeidhm.
data.plan string
Clib an phlean reatha.
data.plan_name string
Ainm inléite den phlean reatha.
data.allowed_types array<string>
Scagairí fearainn atá ar fáil don chuntas seo. Is féidir scagaire aitheanta a chur i gcois do phlean.
data.domains array
Fearainn inroghnaithe tar éis scagtha; tá eagar folamh bailí.
data.domains[].domain string
Ainm fearainn inroghnach.
data.domains[].type string
Lipéad sraith fearainn inléite.
data.domains[].custom boolean
Cé acu an bhfuil sé seo ina fhearann saincheaptha.
POST https://v1.tempmailg.com/api/emails
#

Cruthaigh Bosca Ríomhphoist Sealadach

Cruthaigh bosca poist sealadach úinéir. Fág ainm úsáideora agus fearann ar lár le haghaidh gineadh randamach, nó soláthair ainm úsáideora saincheaptha ceadaithe agus fearann ceadaithe. Is féidir leis an bparaiméadar soláthraí Gmail nó Outlook a roghnú le haghaidh gineadh ailias.

Paraiméadair 8
Paraiméadar Suíomh Sorc Stádas Cur Síos
username body string roghnach
Ainm úsáideora saincheaptha roghnach: 2 go 64 litir ASCII, digití, poncanna, íoslíne nó fleiscíní. Éilíonn sé cead an phláin; glacann sé le custom_username freisin.
Réamhshocrú: Gintear go randamach
domain body string roghnach
Ceann de na fearainn ceadaithe a thugann GET /domains ar ais. Roghnóidh neamhchur fearann ceadaithe randamach.
Réamhshocrú: Fearann ceadaithe randamach
lifetime body string roghnach
luachanna ceadaithe:
10m — 10 Nóiméad 1h — 1 Uair 2h — Dó uair an chloig 1d — Lá Aon 1w — 1 Seachtain 1m — 30 Lá 3m — 90 lá 6m — 180 Lá 1y — 365 Lá unlimited — Gan theorainn
Réamhshocrú: Saolré réamhshocraithe an phlean
provider body string roghnach
Soláthraí bosca poist: caighdeánach, gmail_alias, nó outlook_alias.
Réamhshocrú: standard
pin_enabled body boolean roghnach
Cosaint PIN roghnach don bhosca poist nua, nuair a cheadaítear é ag do phlean. Ní athraíonn sé an PIN de bhosca poist atá ann cheana.
Réamhshocrú: false
pin body string roghnach
Éigeantach nuair atá pin_enabled fíor: PIN de 6 go 8 digit, seolta mar teaghrán chun na nialais tosaigh a chaomhnú.
pin_confirmation body string roghnach
Éigeantach nuair atá pin_enabled fíor. Ní mór go meaitseáil go cruinn leis an bpin.
Idempotency-Key header string roghnach
Riachtanach le haghaidh cruthú nó scriosadh faoi chosaint PIN: eochair chobhsaí 16 go 128 carachtar. Déan an t-iarratas céanna a athdhéanamh leis an eochair chéanna chun obair dhúbailte a sheachaint.
Paraiméadair coirp roghnach: username (ainm úsáideora saincheaptha má cheadaítear é ag an bplean), domain (fearann ceadaithe, m.sh. example.com), lifetime (luachanna ceadaithe: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Fág an tréimhse beatha ar lár, nó fág sé folamh, chun an Tréimhse Beatha Ríomhphoist Réamhshocraithe a úsáid atá cumraithe don phlean míosúil/bliantúil reatha. Seol tréimhse beatha ceadaithe mar shampla 1h chun an réamhshocrú sin a shárú. Úsáidtear gan teorainn ach amháin nuair a bhíonn sé cumraithe mar réamhshocrú an phlean nó nuair a iarrtar go sainráite agus tá sé ceadaithe. Glactar freisin le paraiméadair an choirp mailbox_lifetime agus email_lifetime; bíonn an chéad luach neamhfholamh ag bua in ord seo: lifetime, mailbox_lifetime, email_lifetime. Tuairiscíonn luachanna neamhbhailí nó neamhcheadaithe HTTP 422 in ionad roghnú réamhshocraithe go ciúin.
Cruthaigh bosca poist
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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:21+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:21+00:00",
        "email_token": "encrypted-email-token"
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
data.id integer
ID Bosca Ríomhphoist. Tá IDanna, seoltaí agus comharthaí ginte difriúil do gach bosca ríomhphoist.
data.pin_protected boolean
Cé acu an bhfuil cosaint PIN ag an mbosca poist seo. Ní thugtar PIN ná haon hash PIN ar ais.
data.email string
Seoladh iomlán bosca poist a ghinte.
data.domain string
Fearann an bhosca poist a ghintear.
data.provider string
Soláthraí bosca poist: caighdeánach, gmail_alias, nó outlook_alias.
data.expire_at string|null
Dáta éaga éifeachtach mar timestamp ISO-8601, nó null le haghaidh bosca poist gan teorainn.
data.expires_in_seconds number|null
Soicindí neamh-dhíobhálacha fágtha nuair a ríomhfar; is féidir soicindí codánacha. Null ciallaíonn gan teorainn, ní náid.
data.mailbox_state string
Stádas reatha an bhosca poist: gníomhach, curtha ar sos, caite, nó neamhghníomhach.
data.receiving_enabled boolean
Cé acu an glacann an bosca poist seo teachtaireachtaí isteach faoi láthair.
data.message_count integer
Líon teachtaireachtaí iomlán aitheanta; is féidir leis cur i láthair an sioncrónaithe bosca poist deiridh.
data.unread_message_count integer
Líon na dteachtaireachtaí gan léamh aitheanta; d'fhéadfadh sé léiriú ar an sioncrónú bosca poist is déanaí.
data.last_message_received_at string|null
An t-am deiridh a fuarthas teachtaireacht i bhformáid ISO-8601, nó null nuair nach bhfuil sé ar fáil.
data.message_count_synced_at string|null
Am sioncrónaithe deiridh an chúntais teachtaireachtaí i bhformáid ISO-8601, nó null roimh shioncrónú.
data.created_at string|null
Am cruthaithe bosca poist i bhformáid ISO-8601.
data.email_token string
Tagairt bosca poist criptithe teimhneach. Ní ionadaíonn sé fíordheimhniú Bearer, seiceálacha úinéireachta ná údarú PIN.
data.pin_grant object
Coinníollach: cruthaíonn cruthú bosca poist gníomhach faoi chosaint PIN an cead léite seo; i gcruthú gnáth gan chosaint, ní chuireann sé ar fáil.
data.pin_grant.mailbox_id integer
Aitheantas Bosca Poist a bhfuil an cead léite coinníollach ceangailte leis.
data.pin_grant.unlock_token string
Céad léite teimhneach do X‑Mailbox‑Unlock leis an dintiúir úinéara céanna. Coinnigh é príobháideach agus i gcuimhne; ní údaróidh cead léite scrios.
data.pin_grant.scope string
An raon léite don dheon cruthaithe coinníollach.
data.pin_grant.idle_timeout_seconds integer
Am díomhaoin ceadaithe don cheadúnas léite, de ghnáth 3600 soicind.
data.pin_grant.absolute_timeout_seconds integer
Uasmhéid saoil an chead léite, de ghnáth 86400 soicind.
data.pin_grant.expires_at string
Am éaga reatha an chead léite i bhformáid ISO-8601.
data.pin_grant.absolute_expires_at string
Dáta dlíthe iomlán an chead léite i bhformáid ISO-8601. Is féidir le hathruithe slándála an cead a chúlghairm níos luaithe.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Nuashonraigh / Athraigh Bosca Poist

Cruthaigh nó roghnaigh bosca poist ag an ainm úsáideora agus an fearann nua tar éis fíorú úinéireachta an bhosca poist reatha. Ní athainmníonn sé seo an bosca poist sean ná ní athraíonn sé a shaolré i láthair. Nuair a bhíonn an sprioc difriúil, fanann an bosca poist sean i stair agus d'fhéadfadh sé a bheith curtha ar sos de réir teorainneacha bosca poist gníomhach. Má athúsáideann tú do sprioc ghníomhach féin, cuirtear ar ais a shaolré iarrtha nó réamhshocrú an phlean.

Paraiméadair 9
Paraiméadar Suíomh Sorc Stádas Cur Síos
email path string riachtanach
Seoladh ríomhphoist iomlán reatha den bhosca poist atá i gceannas le hathrú. Códáil URL gach deighleog conair; códáil comhartha plus mar %2B.
username path string riachtanach
Ainm úsáideora nua atá ag teastáil: 2 go 64 carachtar alfa-uimhriúil; faoi réir ceadainm úsáideora saincheaptha.
domain path string riachtanach
Ainm fearainn nua ceadaithe.
lifetime body string roghnach
luachanna ceadaithe:
10m — 10 Nóiméad 1h — 1 Uair 2h — Dó uair an chloig 1d — Lá Aon 1w — 1 Seachtain 1m — 30 Lá 3m — 90 lá 6m — 180 Lá 1y — 365 Lá unlimited — Gan theorainn
Réamhshocrú: Saolré réamhshocraithe an phlean
pin_enabled body boolean roghnach
Cosaint PIN roghnach don bhosca poist nua, nuair a cheadaítear é ag do phlean. Ní athraíonn sé an PIN de bhosca poist atá ann cheana.
Réamhshocrú: false
pin body string roghnach
Éigeantach nuair atá pin_enabled fíor: PIN de 6 go 8 digit, seolta mar teaghrán chun na nialais tosaigh a chaomhnú.
pin_confirmation body string roghnach
Éigeantach nuair atá pin_enabled fíor. Ní mór go meaitseáil go cruinn leis an bpin.
Idempotency-Key header string roghnach
Riachtanach le haghaidh cruthú nó scriosadh faoi chosaint PIN: eochair chobhsaí 16 go 128 carachtar. Déan an t-iarratas céanna a athdhéanamh leis an eochair chéanna chun obair dhúbailte a sheachaint.
X-Mailbox-Unlock header string roghnach
Ceanntásc, boscaí poist cosanta amháin: bain úsáid as unlock_token léite. Seol POST pin agus scope=read chuig URL unlock PIN. Coinnigh d'fhíordheimhniú Bearer gnách. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Úsáid a bhfuil bosca poist úinéir ann cheana i {email}. Paraiméadar optional sa chorp: lifetime (luachanna ceadaithe: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Fág an tréimhse beatha ar lár, nó fág sé folamh, chun an Tréimhse Beatha Ríomhphoist Réamhshocraithe a úsáid atá cumraithe don phlean míosúil/bliantúil reatha. Seol tréimhse beatha ceadaithe mar shampla 1h chun an réamhshocrú sin a shárú. Úsáidtear gan teorainn ach amháin nuair a bhíonn sé cumraithe mar réamhshocrú an phlean nó nuair a iarrtar go sainráite agus tá sé ceadaithe. Glactar freisin le paraiméadair an choirp mailbox_lifetime agus email_lifetime; bíonn an chéad luach neamhfholamh ag bua in ord seo: lifetime, mailbox_lifetime, email_lifetime. Tuairiscíonn luachanna neamhbhailí nó neamhcheadaithe HTTP 422 in ionad roghnú réamhshocraithe go ciúin.
Nuashonraigh bosca poist úinéir
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'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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:21+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:21+00:00",
        "email_token": "encrypted-email-token"
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
data.id integer
ID Bosca Ríomhphoist. Tá IDanna, seoltaí agus comharthaí ginte difriúil do gach bosca ríomhphoist.
data.pin_protected boolean
Cé acu an bhfuil cosaint PIN ag an mbosca poist seo. Ní thugtar PIN ná haon hash PIN ar ais.
data.email string
Seoladh iomlán bosca poist a ghinte.
data.domain string
Fearann an bhosca poist a ghintear.
data.provider string
Soláthraí bosca poist: caighdeánach, gmail_alias, nó outlook_alias.
data.expire_at string|null
Dáta éaga éifeachtach mar timestamp ISO-8601, nó null le haghaidh bosca poist gan teorainn.
data.expires_in_seconds number|null
Soicindí neamh-dhíobhálacha fágtha nuair a ríomhfar; is féidir soicindí codánacha. Null ciallaíonn gan teorainn, ní náid.
data.mailbox_state string
Stádas reatha an bhosca poist: gníomhach, curtha ar sos, caite, nó neamhghníomhach.
data.receiving_enabled boolean
Cé acu an glacann an bosca poist seo teachtaireachtaí isteach faoi láthair.
data.message_count integer
Líon teachtaireachtaí iomlán aitheanta; is féidir leis cur i láthair an sioncrónaithe bosca poist deiridh.
data.unread_message_count integer
Líon na dteachtaireachtaí gan léamh aitheanta; d'fhéadfadh sé léiriú ar an sioncrónú bosca poist is déanaí.
data.last_message_received_at string|null
An t-am deiridh a fuarthas teachtaireacht i bhformáid ISO-8601, nó null nuair nach bhfuil sé ar fáil.
data.message_count_synced_at string|null
Am sioncrónaithe deiridh an chúntais teachtaireachtaí i bhformáid ISO-8601, nó null roimh shioncrónú.
data.created_at string|null
Am cruthaithe bosca poist i bhformáid ISO-8601.
data.email_token string
Tagairt bosca poist criptithe teimhneach. Ní ionadaíonn sé fíordheimhniú Bearer, seiceálacha úinéireachta ná údarú PIN.
data.pin_grant object
Coinníollach: cruthaíonn cruthú bosca poist gníomhach faoi chosaint PIN an cead léite seo; i gcruthú gnáth gan chosaint, ní chuireann sé ar fáil.
data.pin_grant.mailbox_id integer
Aitheantas Bosca Poist a bhfuil an cead léite coinníollach ceangailte leis.
data.pin_grant.unlock_token string
Céad léite teimhneach do X‑Mailbox‑Unlock leis an dintiúir úinéara céanna. Coinnigh é príobháideach agus i gcuimhne; ní údaróidh cead léite scrios.
data.pin_grant.scope string
An raon léite don dheon cruthaithe coinníollach.
data.pin_grant.idle_timeout_seconds integer
Am díomhaoin ceadaithe don cheadúnas léite, de ghnáth 3600 soicind.
data.pin_grant.absolute_timeout_seconds integer
Uasmhéid saoil an chead léite, de ghnáth 86400 soicind.
data.pin_grant.expires_at string
Am éaga reatha an chead léite i bhformáid ISO-8601.
data.pin_grant.absolute_expires_at string
Dáta dlíthe iomlán an chead léite i bhformáid ISO-8601. Is féidir le hathruithe slándála an cead a chúlghairm níos luaithe.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Scrios Bosca Ríomhphoist

Scrios bosca poist úinéir agus cuir i bhfeidhm a ghlanadh teachtaireachtaí agus comhad. D'fhéadfadh taifid bosca poist coimeádta a bheith bog-dealraithe go intí; ní féidir an seoladh a úsáid níos mó tríd an API.

Paraiméadair 3
Paraiméadar Suíomh Sorc Stádas Cur Síos
email path string riachtanach
Seoladh ríomhphoist iomlán den bhosca poist úinéir le scriosadh. Códú URL an seoladh; códú comhartha plus mar %2B.
X-Mailbox-Unlock header string roghnach
Ceanntásc, boscaí poist cosanta amháin: bain úsáid as an unlock_token scriosadh aon‑úsáid. An chéad POST pin, scope=delete agus an action/target_id a thugtar ar ais ag an bhfreagra 423 chuig an URL unlock PIN. Ní féidir le comhartha léite a scriosadh. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string roghnach
Riachtanach le haghaidh cruthú nó scriosadh faoi chosaint PIN: eochair chobhsaí 16 go 128 carachtar. Déan an t-iarratas céanna a athdhéanamh leis an eochair chéanna chun obair dhúbailte a sheachaint.
Scríobh bosca poist úinéir
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
message string
Toradh an scriosta. Aimsíonn acmhainn ar iarraidh cód HTTP 404.

Gmail & Outlook Aliasanna

Gin boscaí ríomhphoist ailias Gmail agus Outlook/Hotmail le dea-cháil.

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

Cruthaigh Alias Gmail

Cruthaigh ailias Gmail nua, bosca poist sealadach a bhfuil úinéir air an t-úsáideoir fíordheimhnithe.

Paraiméadair 8
Paraiméadar Suíomh Sorc Stádas Cur Síos
mode body string roghnach
Mód gineadh: auto, dot, plus, nó plus_dot. Glacann sé freisin le gmail_alias_mode. Mura ceadaítear roghnú stíle, úsáidtear auto.
Réamhshocrú: auto
username body string roghnach
Iarmhír saincheaptha roghnach: 2 go 32 litir ASCII nó digit, caighdeánaithe go dtí an cás íochtair; faoi cheadúnas gné. Glacann sé freisin le custom_username nó alias_username.
Réamhshocrú: Uatho-ghinte
domain body string roghnach
Úsáid randamach, gmail.com nó googlemail.com; glacfar le alias_domain freisin. Má dhéantar neamhaird nó nach bhfuil cead roghnú fearainn ar fáil, úsáidtear randamach.
Réamhshocrú: random
lifetime body string roghnach
luachanna ceadaithe:
10m — 10 Nóiméad 1h — 1 Uair 2h — Dó uair an chloig 1d — Lá Aon 1w — 1 Seachtain 1m — 30 Lá 3m — 90 lá 6m — 180 Lá 1y — 365 Lá unlimited — Gan theorainn
Réamhshocrú: Saolré réamhshocraithe an phlean
pin_enabled body boolean roghnach
Cosaint PIN roghnach don bhosca poist nua, nuair a cheadaítear é ag do phlean. Ní athraíonn sé an PIN de bhosca poist atá ann cheana.
Réamhshocrú: false
pin body string roghnach
Éigeantach nuair atá pin_enabled fíor: PIN de 6 go 8 digit, seolta mar teaghrán chun na nialais tosaigh a chaomhnú.
pin_confirmation body string roghnach
Éigeantach nuair atá pin_enabled fíor. Ní mór go meaitseáil go cruinn leis an bpin.
Idempotency-Key header string roghnach
Riachtanach le haghaidh cruthú nó scriosadh faoi chosaint PIN: eochair chobhsaí 16 go 128 carachtar. Déan an t-iarratas céanna a athdhéanamh leis an eochair chéanna chun obair dhúbailte a sheachaint.
Éilíonn sé cead API Alias Gmail a bheith cumasaithe ar do phlean síntiúis nó a bheith díghlasáilte trí phacáiste API Credit. Paraiméadair roghnach: mode (auto, dot, plus, plus_dot), username (ainm úsáideora alias saincheaptha), domain (m.sh. gmail.com, googlemail.com), lifetime (luachanna ceadaithe: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Fág an tréimhse beatha ar lár, nó fág sé folamh, chun an Tréimhse Beatha Ríomhphoist Réamhshocraithe a úsáid atá cumraithe don phlean míosúil/bliantúil reatha. Seol tréimhse beatha ceadaithe mar shampla 1h chun an réamhshocrú sin a shárú. Úsáidtear gan teorainn ach amháin nuair a bhíonn sé cumraithe mar réamhshocrú an phlean nó nuair a iarrtar go sainráite agus tá sé ceadaithe. Glactar freisin le paraiméadair an choirp mailbox_lifetime agus email_lifetime; bíonn an chéad luach neamhfholamh ag bua in ord seo: lifetime, mailbox_lifetime, email_lifetime. Tuairiscíonn luachanna neamhbhailí nó neamhcheadaithe HTTP 422 in ionad roghnú réamhshocraithe go ciúin.
Cruthaigh bosca ríomhphoist 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'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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:21+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:21+00:00",
        "email_token": "encrypted-email-token"
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
data.id integer
ID Bosca Ríomhphoist. Tá IDanna, seoltaí agus comharthaí ginte difriúil do gach bosca ríomhphoist.
data.pin_protected boolean
Cé acu an bhfuil cosaint PIN ag an mbosca poist seo. Ní thugtar PIN ná haon hash PIN ar ais.
data.email string
Seoladh iomlán bosca poist a ghinte.
data.domain string
Fearann an bhosca poist a ghintear.
data.provider string
Soláthraí bosca poist: caighdeánach, gmail_alias, nó outlook_alias.
data.expire_at string|null
Dáta éaga éifeachtach mar timestamp ISO-8601, nó null le haghaidh bosca poist gan teorainn.
data.expires_in_seconds number|null
Soicindí neamh-dhíobhálacha fágtha nuair a ríomhfar; is féidir soicindí codánacha. Null ciallaíonn gan teorainn, ní náid.
data.mailbox_state string
Stádas reatha an bhosca poist: gníomhach, curtha ar sos, caite, nó neamhghníomhach.
data.receiving_enabled boolean
Cé acu an glacann an bosca poist seo teachtaireachtaí isteach faoi láthair.
data.message_count integer
Líon teachtaireachtaí iomlán aitheanta; is féidir leis cur i láthair an sioncrónaithe bosca poist deiridh.
data.unread_message_count integer
Líon na dteachtaireachtaí gan léamh aitheanta; d'fhéadfadh sé léiriú ar an sioncrónú bosca poist is déanaí.
data.last_message_received_at string|null
An t-am deiridh a fuarthas teachtaireacht i bhformáid ISO-8601, nó null nuair nach bhfuil sé ar fáil.
data.message_count_synced_at string|null
Am sioncrónaithe deiridh an chúntais teachtaireachtaí i bhformáid ISO-8601, nó null roimh shioncrónú.
data.created_at string|null
Am cruthaithe bosca poist i bhformáid ISO-8601.
data.email_token string
Tagairt bosca poist criptithe teimhneach. Ní ionadaíonn sé fíordheimhniú Bearer, seiceálacha úinéireachta ná údarú PIN.
data.pin_grant object
Coinníollach: cruthaíonn cruthú bosca poist gníomhach faoi chosaint PIN an cead léite seo; i gcruthú gnáth gan chosaint, ní chuireann sé ar fáil.
data.pin_grant.mailbox_id integer
Aitheantas Bosca Poist a bhfuil an cead léite coinníollach ceangailte leis.
data.pin_grant.unlock_token string
Céad léite teimhneach do X‑Mailbox‑Unlock leis an dintiúir úinéara céanna. Coinnigh é príobháideach agus i gcuimhne; ní údaróidh cead léite scrios.
data.pin_grant.scope string
An raon léite don dheon cruthaithe coinníollach.
data.pin_grant.idle_timeout_seconds integer
Am díomhaoin ceadaithe don cheadúnas léite, de ghnáth 3600 soicind.
data.pin_grant.absolute_timeout_seconds integer
Uasmhéid saoil an chead léite, de ghnáth 86400 soicind.
data.pin_grant.expires_at string
Am éaga reatha an chead léite i bhformáid ISO-8601.
data.pin_grant.absolute_expires_at string
Dáta dlíthe iomlán an chead léite i bhformáid ISO-8601. Is féidir le hathruithe slándála an cead a chúlghairm níos luaithe.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Fearainn Alias Outlook

Faigh fearainn alias Outlook / Hotmail gníomhacha atá ar fáil le haghaidh giniúint bosca poist.

Éilíonn sé cead API Alias Outlook a bheith cumasaithe ar do phlean síntiús nó a bheith díghlasáilte trí phacáiste Creidmheas API. Léiríonn sé an bhfuil rogha fearainn ar leith díghlasáilte ar do phlean.
Faigh fearainn 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'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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
            }
        ]
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
data.domains array
Fearainn Outlook/Hotmail gníomhacha; tá eagar folamh bailí.
data.domains[].domain string
Ainm fearainn ar fáil.
data.domains[].type string
Lipéad soláthraí inléite.
data.domains[].selectable boolean
Cibé ar féidir le do chuntas roghnú go sainráite an fearann seo.
data.domains[].locked boolean
Cé acu an bhfuil roghnú fearainn sainráite faoi ghlas do do chuntas.
data.domains[].disabled_reason string|null
Cúis go bhfuil roghnú fearainn faoi ghlas, nó null nuair is féidir é a roghnú.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Cruthaigh Alias Outlook

Cruthaigh bosca poist sealadach alias Outlook / Hotmail nua atá i seilbh an úsáideora fíordheimhnithe.

Paraiméadair 7
Paraiméadar Suíomh Sorc Stádas Cur Síos
domain body string roghnach
Úsáid randamach nó fearann ó GET /outlook-alias/domains; glacann outlook_alias_domain freisin. Gan cead roghnaithe, úsáidtear randamach.
Réamhshocrú: Fearann ar fáil randamach
username body string roghnach
Iarmhír saincheaptha roghnach: 2 go 32 litir ASCII nó digit, caighdeánaithe go dtí an cás íochtair; faoi cheadúnas gné. Glacann sé freisin le custom_username nó alias_username.
Réamhshocrú: Uatho-ghinte
lifetime body string roghnach
luachanna ceadaithe:
10m — 10 Nóiméad 1h — 1 Uair 2h — Dó uair an chloig 1d — Lá Aon 1w — 1 Seachtain 1m — 30 Lá 3m — 90 lá 6m — 180 Lá 1y — 365 Lá unlimited — Gan theorainn
Réamhshocrú: Saolré réamhshocraithe an phlean
pin_enabled body boolean roghnach
Cosaint PIN roghnach don bhosca poist nua, nuair a cheadaítear é ag do phlean. Ní athraíonn sé an PIN de bhosca poist atá ann cheana.
Réamhshocrú: false
pin body string roghnach
Éigeantach nuair atá pin_enabled fíor: PIN de 6 go 8 digit, seolta mar teaghrán chun na nialais tosaigh a chaomhnú.
pin_confirmation body string roghnach
Éigeantach nuair atá pin_enabled fíor. Ní mór go meaitseáil go cruinn leis an bpin.
Idempotency-Key header string roghnach
Riachtanach le haghaidh cruthú nó scriosadh faoi chosaint PIN: eochair chobhsaí 16 go 128 carachtar. Déan an t-iarratas céanna a athdhéanamh leis an eochair chéanna chun obair dhúbailte a sheachaint.
Éilíonn sé cead API Alias Outlook a bheith cumasaithe ar do phlean síntiús nó a bheith díghlasáilte trí phacáiste Creidmheas API. Paraiméadair roghnach: domain (m.sh. outlook.com, hotmail.com), username (ainm úsáideora alias saincheaptha), lifetime (luachanna ceadaithe: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Fág an tréimhse beatha ar lár, nó fág sé folamh, chun an Tréimhse Beatha Ríomhphoist Réamhshocraithe a úsáid atá cumraithe don phlean míosúil/bliantúil reatha. Seol tréimhse beatha ceadaithe mar shampla 1h chun an réamhshocrú sin a shárú. Úsáidtear gan teorainn ach amháin nuair a bhíonn sé cumraithe mar réamhshocrú an phlean nó nuair a iarrtar go sainráite agus tá sé ceadaithe. Glactar freisin le paraiméadair an choirp mailbox_lifetime agus email_lifetime; bíonn an chéad luach neamhfholamh ag bua in ord seo: lifetime, mailbox_lifetime, email_lifetime. Tuairiscíonn luachanna neamhbhailí nó neamhcheadaithe HTTP 422 in ionad roghnú réamhshocraithe go ciúin.
Cruthaigh bosca poist ailias Outlook
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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:21+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:21+00:00",
        "email_token": "encrypted-email-token"
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
data.id integer
ID Bosca Ríomhphoist. Tá IDanna, seoltaí agus comharthaí ginte difriúil do gach bosca ríomhphoist.
data.pin_protected boolean
Cé acu an bhfuil cosaint PIN ag an mbosca poist seo. Ní thugtar PIN ná haon hash PIN ar ais.
data.email string
Seoladh iomlán bosca poist a ghinte.
data.domain string
Fearann an bhosca poist a ghintear.
data.provider string
Soláthraí bosca poist: caighdeánach, gmail_alias, nó outlook_alias.
data.expire_at string|null
Dáta éaga éifeachtach mar timestamp ISO-8601, nó null le haghaidh bosca poist gan teorainn.
data.expires_in_seconds number|null
Soicindí neamh-dhíobhálacha fágtha nuair a ríomhfar; is féidir soicindí codánacha. Null ciallaíonn gan teorainn, ní náid.
data.mailbox_state string
Stádas reatha an bhosca poist: gníomhach, curtha ar sos, caite, nó neamhghníomhach.
data.receiving_enabled boolean
Cé acu an glacann an bosca poist seo teachtaireachtaí isteach faoi láthair.
data.message_count integer
Líon teachtaireachtaí iomlán aitheanta; is féidir leis cur i láthair an sioncrónaithe bosca poist deiridh.
data.unread_message_count integer
Líon na dteachtaireachtaí gan léamh aitheanta; d'fhéadfadh sé léiriú ar an sioncrónú bosca poist is déanaí.
data.last_message_received_at string|null
An t-am deiridh a fuarthas teachtaireacht i bhformáid ISO-8601, nó null nuair nach bhfuil sé ar fáil.
data.message_count_synced_at string|null
Am sioncrónaithe deiridh an chúntais teachtaireachtaí i bhformáid ISO-8601, nó null roimh shioncrónú.
data.created_at string|null
Am cruthaithe bosca poist i bhformáid ISO-8601.
data.email_token string
Tagairt bosca poist criptithe teimhneach. Ní ionadaíonn sé fíordheimhniú Bearer, seiceálacha úinéireachta ná údarú PIN.
data.pin_grant object
Coinníollach: cruthaíonn cruthú bosca poist gníomhach faoi chosaint PIN an cead léite seo; i gcruthú gnáth gan chosaint, ní chuireann sé ar fáil.
data.pin_grant.mailbox_id integer
Aitheantas Bosca Poist a bhfuil an cead léite coinníollach ceangailte leis.
data.pin_grant.unlock_token string
Céad léite teimhneach do X‑Mailbox‑Unlock leis an dintiúir úinéara céanna. Coinnigh é príobháideach agus i gcuimhne; ní údaróidh cead léite scrios.
data.pin_grant.scope string
An raon léite don dheon cruthaithe coinníollach.
data.pin_grant.idle_timeout_seconds integer
Am díomhaoin ceadaithe don cheadúnas léite, de ghnáth 3600 soicind.
data.pin_grant.absolute_timeout_seconds integer
Uasmhéid saoil an chead léite, de ghnáth 86400 soicind.
data.pin_grant.expires_at string
Am éaga reatha an chead léite i bhformáid ISO-8601.
data.pin_grant.absolute_expires_at string
Dáta dlíthe iomlán an chead léite i bhformáid ISO-8601. Is féidir le hathruithe slándála an cead a chúlghairm níos luaithe.

Teachtaireachtaí & Iatáin

Faigh boscaí isteach, léigh teachtaireachtaí iomlána HTML/téacs, agus sruthlaigh iatáin.

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

Liosta Teachtaireachtaí Bosca Poist

Faigh achoimrí teachtaireachtaí atá ar fáil agus meiteashonraí bosca poist. Cuireann scananna caighdeánacha bosca isteach ar ais beart le déanaí de suas le 25 teachtaireacht; ní críochphointe le stair iomlán leathanach. Úsáid GET /messages/{messageId} le haghaidh corpanna iomlána agus iatáin.

Paraiméadair 2
Paraiméadar Suíomh Sorc Stádas Cur Síos
email query string riachtanach
Seoladh iomlán ríomhphoist den bhosca poist atá i do úinéireacht chun teachtaireachtaí a léamh ó. Códú URL an luach iarratais; códú comhartha plus mar %2B.
X-Mailbox-Unlock header string roghnach
Ceanntásc, boscaí poist cosanta amháin: bain úsáid as unlock_token léite. Seol POST pin agus scope=read chuig URL unlock PIN. Coinnigh d'fhíordheimhniú Bearer gnách. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Ní mór don ríomhphost a bheith i do chuntas. Tá réimsí OTP agus verification-link i achoimrí caighdeánacha agus Gmail; cuimsíonn Outlook freisin from_name, snippet, received_at agus has_attachments. Is féidir le sioncrónú soláthraí agus taisce a chur moill ar teachtaireachtaí nua agus ar na huimhreacha.
Léigh teachtaireachtaí bosca poist
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'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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:21",
            "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:21+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:21+00:00",
    "message_count_synced_at": "2026-11-19T02:18:21+00:00"
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
mailbox string
Seoladh bosca poist a d'iarradh a chuid teachtaireachtaí.
email_token string
Tagairt bosca poist criptithe teimhneach; tá fíordheimhniú caighdeánach fós ag teastáil.
mailbox_provider string
Soláthraí bosca poist: caighdeánach, gmail_alias, nó outlook_alias.
messages array
Achoimre na dteachtaireachtaí. Tuairisceann bosca isteach folamh eagar folamh; aisghabh teachtaireacht amháin chun a chorp agus a iatáin a fháil.
expire_at string|null
Dáta éaga éifeachtach mar timestamp ISO-8601, nó null le haghaidh bosca poist gan teorainn.
expires_in_seconds number|null
Soicindí neamh-dhíobhálacha fágtha nuair a ríomhfar; is féidir soicindí codánacha. Null ciallaíonn gan teorainn, ní náid.
mailbox_state string
Stádas reatha an bhosca poist: gníomhach, curtha ar sos, caite, nó neamhghníomhach.
receiving_enabled boolean
Cé acu an glacann an bosca poist seo teachtaireachtaí isteach faoi láthair.
message_count integer
Líon teachtaireachtaí iomlán aitheanta; is féidir leis cur i láthair an sioncrónaithe bosca poist deiridh.
unread_message_count integer
Líon na dteachtaireachtaí gan léamh aitheanta; d'fhéadfadh sé léiriú ar an sioncrónú bosca poist is déanaí.
last_message_received_at string|null
An t-am deiridh a fuarthas teachtaireacht i bhformáid ISO-8601, nó null nuair nach bhfuil sé ar fáil.
message_count_synced_at string|null
Am sioncrónaithe deiridh an chúntais teachtaireachtaí i bhformáid ISO-8601, nó null roimh shioncrónú.
mailbox_limit.limit integer
Teorainn bosca poist gníomhach don soláthraí seo; ciallaíonn -1 gan teorainn.
mailbox_limit.limit_label string
Lipéad taispeána don teorainn bosca poist.
mailbox_limit.active_count integer
Líon na bhoscaí ríomhphoist gníomhacha don soláthraí seo.
mailbox_limit.paused_count integer
Líon na bboscaí poist curtha ar sos don soláthraí seo.
mailbox_limit.paused_mailboxes array<string>
Seoltaí curtha ar fionraí de bharr teorainn an bhosca poist.
mailbox_limit.remaining integer
Sliotáin bhosca poist gníomhacha atá fágtha; ciallaíonn -1 gan teorainn. Ní é seo an cuóta iarratais API.
mailbox_limit.remaining_label string
Taispeáin lipéad do na sliotáin bosca poist atá fágtha.
mailbox_limit.reached boolean
Cé acu an bhfuil teorainn an bhosca poist gníomhach bainte amach.
mailbox_limit.blocked boolean
Cibé an bhfuil teorainn an bhosca poist gníomhach náid.
mailbox_limit.provider string|null
Soláthraí a gcuirtear teorainn an bhosca poist i bhfeidhm air.
messages[].id string
Opaque message ID used by the single-message, deletion and attachment endpoints.
messages[].is_seen boolean
Cibé an bhfuil an teachtaireacht marcáilte mar léite.
messages[].subject string
Ábhar teachtaireachta.
messages[].from string
Ainm taispeána an tseoltóra nó seoladh.
messages[].from_email string
Seoladh ríomhphoist an tseoltóra.
messages[].receivedAt string
Am faighte i crios ama an fheidhmchláir, formáidithe mar YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Braitheadh cód aon uair nuair atá sé ar fáil agus ceadaithe; i ngach cás eile, null.
messages[].otp_locked boolean
Cibé an bhfuil cód aon uair amháin braite i bhfolach ag ceadanna na gné.
messages[].verification_link string|null
URL fíoraithe braite nuair atá sé ar fáil agus ceadaithe; i ngach cás eile null.
messages[].verification_link_locked boolean
Cibé an bhfuil nasc fíorúcháin braite i bhfolach de bharr ceadanna gné.
messages[].from_name string|null
Réimse achoimre Outlook: ainm an seoltóra bunaidh. Níl sé i láthair i achoimrí Caighdeánacha agus Gmail.
messages[].snippet string|null
Réimse achoimre Outlook: réamhamharc gearr ar theachtaireacht.
messages[].received_at string|null
Réimse achoimre Outlook: am faighte ISO-8601, nuair a bhfuil sé ar eolas.
messages[].has_attachments boolean
Réimse achoimre Outlook: an bhfuil meiteashonraí iatáin ann. Déantar an infhaighteacht íoslódála a sheiceáil ar leith.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Faigh Teachtaireacht Aonair

Faigh teachtaireacht úinéireachta de réir a ID teachtaireachta teimhneach. Cuireann sé ar ais formáidí an choirp agus meiteashonraí iatáin. Braitheann réimsí an choirp ar fhormáid na teachtaireachta; cuireann Outlook réimsí ar leith don sholáthraí a liostáil thíos.

Paraiméadair 2
Paraiméadar Suíomh Sorc Stádas Cur Síos
messageId path string riachtanach
Aitheantas teachtaireachta uathúil a thugtar ar ais sa liosta teachtaireachtaí.
X-Mailbox-Unlock header string roghnach
Ceanntásc, boscaí poist cosanta amháin: bain úsáid as unlock_token léite. Seol POST pin agus scope=read chuig URL unlock PIN. Coinnigh d'fhíordheimhniú Bearer gnách. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Léigh teachtaireacht amháin
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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:21",
        "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"
            }
        ]
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
data.id string
Aitheantas teachtaireachta teimhneach.
data.is_seen boolean
Staid léite teachtaireachta. Is féidir léamh a mharcáil mar fheicthe; d'fhéadfadh sonraí taisce léiriú a dhéanamh ar staid roimhe seo.
data.subject string
Ábhar teachtaireachta.
data.from string
Ainm taispeána an tseoltóra nó seoladh.
data.from_email string
Seoladh ríomhphoist an tseoltóra.
data.to string
Seoladh bosca poist an faighteora.
data.mailbox_provider string
Soláthraí bosca poist: caighdeánach, gmail_alias, nó outlook_alias.
data.receivedAt string
Am faighte i crios ama an fheidhmchláir, formáidithe mar YYYY-MM-DD HH:mm:ss.
data.html boolean
Cé acu an bhfuil corp HTML ag an teachtaireacht.
data.html_content string
Corpa HTML nuair atá sé i láthair. Is féidir le teachtaireachtaí caighdeánacha gan HTML an réimse seo a fhágáil. Caith le hábhar na teachtaireachta mar neamhiontaofa.
data.text_content string
Corpa téacs nuair atá sé i láthair; D’fhéadfadh teachtaireachtaí caighdeánacha téacs éalaithe a bheith i ndéanach pre element nó an réimse seo a fhágáil.
data.content string
Corp roghnaithe le cur i láthair, de ghnáth HTML nuair atá sé ar fáil.
data.attachments array
Attachment metadata, or an empty array. Downloads require normal authentication and applicable PIN authorization.
data.attachments[].name string
Filename to URL-encode as a single path segment when downloading.
data.attachments[].size integer
Méid an cheangáin i mbearta.
data.attachments[].url string
Cuireadh URL íoslódála API an Úsáideora Fíordheimhnithe le hiatáin le comhadainm. Ní ráthaíonn URL go bhfuil an comhad áitiúil ar fáil.
data.attachments[].extension string
Réimse meiteashonraí Caighdeánach/Gmail: iarmhír comhaid nuair a sholáthraítear.
data.attachments[].id string
Outlook metadata field: provider attachment ID.
data.attachments[].content_type string
Réimse meiteashonraí Outlook: cineál ábhair MIME.
data.from_name string|null
Réimse mionsonraí Outlook: ainm an tseoltóra bunaidh.
data.to_email string|null
Réimse sonraí Outlook: seoladh an fhaighteora bunaidh.
data.received_at string|null
Réimse sonraí Outlook: am faighte ISO-8601.
data.has_html boolean
Réimse sonraí Outlook: an bhfuil corp HTML ann.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Scrios Teachtaireacht

Scríobh teachtaireacht aonair úinéir.

Paraiméadair 3
Paraiméadar Suíomh Sorc Stádas Cur Síos
messageId path string riachtanach
Teaghrán ID teachtaireachta uathúil le scriosadh go buan.
X-Mailbox-Unlock header string roghnach
Ceanntásc, boscaí poist cosanta amháin: bain úsáid as an unlock_token scriosadh aon‑úsáid. An chéad POST pin, scope=delete agus an action/target_id a thugtar ar ais ag an bhfreagra 423 chuig an URL unlock PIN. Ní féidir le comhartha léite a scriosadh. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string roghnach
Riachtanach le haghaidh cruthú nó scriosadh faoi chosaint PIN: eochair chobhsaí 16 go 128 carachtar. Déan an t-iarratas céanna a athdhéanamh leis an eochair chéanna chun obair dhúbailte a sheachaint.
Scrios aon teachtaireacht
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Réimsí freagra
Réimse Sorc Cur Síos
status boolean
Cibé an d'éirigh leis an gníomh.
message string
Toradh an scriosta. Aimsíonn acmhainn ar iarraidh cód HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Íosluchtaigh iatán

Íoslódáil ceangal ó theachtaireacht úinéir

Paraiméadair 3
Paraiméadar Suíomh Sorc Stádas Cur Síos
messageId path string riachtanach
ID an teachtaireachta a bhfuil an comhad ann.
filename path string riachtanach
Ainm comhaid agus síneadh an iatáin le híoslódáil.
X-Mailbox-Unlock header string roghnach
Ceanntásc, boscaí poist cosanta amháin: bain úsáid as unlock_token léite. Seol POST pin agus scope=read chuig URL unlock PIN. Coinnigh d'fhíordheimhniú Bearer gnách. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Rath cuireann bearta comhaid ar ais, ní JSON. Cuireann comhaid rómhór HTTP 403 ar ais; cuireann comhaid áitiúla ar iarraidh nó nach bhfuil ar fáil HTTP 404 ar ais. Déan an t-ainm comhaid a URL-chódaigh mar aon mhír chosáin. Ní ráthaíonn meiteashonraí an cheangailte go léir inrochtaineacht íoslódála.
Íoslódáil ceangal
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
Iompróid íoslódála Tá an ceannphointe seo ag filleadh an comhad iarrtha go díreach in ionad coirp JSON.
Réimsí freagra
Réimse Sorc Cur Síos
Content-Disposition header
Íoslódálann freagra rathúil an comhadainm iarrtha.
body binary
Bearta comhaid ar rath, ní JSON. Tabharann earráidí JSON le stádas nach bhfuil 2xx.

Teorainneacha rátaí & cuótaí

Rianaigh buiséid iarratais fíor-ama, teorainneacha rátaí, agus cuótaí cuntais gan creidmheanna a ídiú.

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

Teorainn ráta & cuóta

Seiceáil do theorainn ráta reatha agus stádas cuóta gan aon úsáid API a ídiú. Tá an críochphointe seo saor ó chuóta agus ní laghdaíonn sé creidmheasanna míosúla API (teorainn cosanta mí-úsáide: 60 iarratas/nóiméad).

Cuireann X-RateLimit-* síos ar an bhuiséad iarratais atá leagtha amach; cuireann X-Quota-* síos ar an gcapasacht mhíosúil agus a ceannaíodh nuair atá sé ar fáil. Tuairiscíonn X-Mailbox-RateLimit-* ar an bhuiséad cruthú/nuashonraithe bosca poist ar leith. Úsáideann diúltú bosca poist amháin raon bosca poist agus a fhuinneog athiarraíochta féin. D’fhéadfadh diúltuithe teorainn nóiméad a fhágáil amach eolas cquota. Tá Retry-After san áireamh ach le haghaidh athiarraíocht ama; d’fhéadfadh rochtain díchumasaithe athrú cuntais a éileamh. Sa fhreagra stádais rathúil seo, míníonn data.limit, data.remaining agus data.reset buiséad nóiméad an chuntais, ní na creidmheasanna inúsáidte. Míníonn an réad data.quota cead míosúil, iarmhéideanna creidmheas agus úsáid. Fanann na réimsí data.monthly_limit, data.monthly_remaining agus data.purchased_credits atá ann cheana mar ailiasí na réimsí quota comhfhreagracha. Ní údaróidh seiceáil stádais rathúil oibríocht API eile. Tá rochtain cumasaithe, cuóta ar fáil agus ceadú trí gach teorainn infheidhme fós ag teastáil ó na hoibríochtaí. Ní gheallann an léaráid cuóta acmhainn atá á chur in áirithe cheana féin ag iarratas atá ar siúl.
Seiceáil stádas teorainn ráta
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Freagra léiriúcháin ag baint úsáide as sonraí sintéiseacha. Tá IDanna, seoltaí, comharthaí, stampaí ama, teorainneacha an phláin agus líonra ag athrú. Ní sháraíonn samplaí saoilréimse réamhshocraithe do phlean. Sonraíonn cur síos ar réimsí freagra na réimsí inbhainte agus na réimsí ar leith don sholáthraí.

Freagra samplach
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"
        }
    }
}
Réimsí freagra
Réimse Sorc Cur Síos
data.limit integer|string
Teorainn iarratais cuntais in aghaidh an nóiméid. Léiríonn an teaghrán unlimited buiséad nóiméad gan teorainn; tá sé seo neamhspleách de chóta míosúil.
data.remaining integer|string
Sliotáin buiséad nóiméad cuntais atá fágtha, nó an teaghrán unlimited. Ní chiallaíonn luach dearfach go bhfuil creidiúintí API fágtha.
data.reset integer
Soicindí don fhuinneog nóiméad an chuntais, ní don athshocrú cóta míosúil. Is féidir le buiséid nóiméad díchumasaithe nó gan teorainn a choinneáil luach nómhais 60 soicind; ní gheallann sé rochtain tar éis fanachta.
data.plan string
Clib an phlean reatha. Cuirtear ainm an phlean inléite ar leith ar fáil i data.quota.plan_name.
data.quota.enabled boolean
Cé acu an bhfuil rochtain API dhomhanda agus plean/creidmheas cumasaithe. Ní thaispeánann sé seo an acmhainn fágtha ná ionadú an lasc API úsáideora.
data.quota.user_api_status boolean
Cé acu an bhfuil an t-úsáideoir tar éis a chasúr API Úsáideora a chumasú. Éilíonn oibríochtaí an casúr seo chomh maith le rochtain chumasaithe agus acmhainn atá ar fáil.
data.quota.plan_name string
Ainm inléite den phlean reatha.
data.quota.period string
Tréimhse úsáide mí na féilire i bhformáid YYYY-MM, ag baint úsáide as crios ama an fheidhmchláir; ní gá go mbeadh sé de dhíth ar an tréimhse billeála síntiús.
data.quota.base_limit integer
Ceadúnas bunúsach an phlean míosúil. Ciallaíonn luach -1 gan teorainn.
data.quota.extra_requests integer
Ceadúnas míosúil breise a deonadh don tréimhse úsáide reatha; ar leithligh ó chreidmheasanna ceannaite.
data.quota.monthly_limit integer
Ceadúnas bunúsach plus iarratais bhreise don tréimhse reatha. Ciallaíonn luach -1 gan teorainn. Ní chuimsítear creidiúintí ceannaite.
data.quota.monthly_remaining integer|null
Leasúnas míosúil teoranta atá fágtha, nó null nuair atá an cuóta míosúil gan teorainn. Níor cheart null a léirmhíniú mar nialas.
data.quota.used integer
Oibríochtaí API rathúla, á n-áireamh sa tréimhse úsáide reatha, lena n-áirítear oibríochtaí a úsáideann creidmheasanna. Ní mhéadaíonn seiceálacha stádais an luach seo.
data.quota.purchased_credits integer
Iarmhéid creidmheas reatha, lena n-áirítear creidmheasanna bonais an phlean gníomhach. Níor cheart creidmheasanna bonais a chur leis an iarmhéid seo dara huair.
data.quota.bonus_credits integer
Cuid bhónas an phlean gníomhach den iarmhéid creidmheasa; scoilsiú de purchased_credits, ní cumas breise.
data.quota.direct_purchased_credits integer
Iarmhéid creidmheasa gan an cuid bónas an phlean gníomhach. Tá an luach seo le bonus_credits cothrom le purchased_credits.
data.quota.remaining integer|null
Ceadúint mhíosúil atá fágtha plus an iarmhéid creidmheasa reatha, gan bonais a dhúbailt. Ciallaíonn Null cquota míosúil gan teorainn. Bíonn ceadanna gnéithe aonair agus teorainneacha iarratais eile fós i bhfeidhm.
data.quota.unlimited boolean
Cé acu an bhfuil cuóta mhíosúil gan teorainn. Ní chuireann sé seo buiséad nóiméad an chuntais ná teorainneacha gné eile gan teorainn.
data.quota.usage_percent integer
Céatadán cruinn ó 0 go 100 atá comhoiriúnach le Painéal: úsáidte roinnte le húsáidte móide an chuid atá fágtha, iolrú le 100. Cuimsíonn sé acmhainn creidmheasa atá ar fáil, mar sin d'fhéadfadh athluchtú an céatadán a ísliú. Tá sé 0 do chuóta gan teorainn nó le linn a bhfuil an linn neamhtheoranta; ní hé seo an céatadán teorainn ráta nó cinneadh rochtana.
data.quota.reset_at string
Stampa ama ISO-8601 le fritháireamh criostaire don athshocrú cuóta an mhí féilire seo chugainn. Ní é seo an dáta críochnaithe an tsíntiús, agus ní athlíonann an athshocrú míosúil na creidmheanna ceannaite.
status string
An rath litriúil don chríochnachas stádais seo. Úsáidtear an luach boolach fíor ag críochnachtaí bosca ríomhphoist rathúla eile.
data.monthly_limit integer
Ailias comhoiriúnachta den réimse data.quota comhfhreagrach; ná cuir leis arís nuair a ríomhann tú iarmhéid.
data.monthly_remaining integer|null
Ailias comhoiriúnachta den réimse data.quota comhfhreagrach; ná cuir leis arís nuair a ríomhann tú iarmhéid.
data.purchased_credits integer
Ailias comhoiriúnachta den réimse data.quota comhfhreagrach; ná cuir leis arís nuair a ríomhann tú iarmhéid.

Cosaint PIN Bosca Poist

Cuir isteach an PIN chun leanúint ar aghaidh. Fanann do bhosca poist díghlasáilte fad is atá sé reatha i seisiún an tsuímh ghréasáin seo.

An d'achtann tú fianáin?

Úsáidimid fianáin chun do thaithí brabhsála a fheabhsú. Trí úsáid a bhaint as an suíomh seo, deonaíonn tú d’fhógráil fianán.

Níos mó