TempMailg API-dokumentaatio

REST API v1 & Webhookit

TempMailg Kehittäjän API-dokumentaatio

Käytä tätä dokumentaatiota luomaan henkilökohtainen API-avain, yhdistää omistettu käyttäjän API-isäntä, lukea postilaatikon viestejä, hallita omia postilaatikoita ja integroida Temp Mail omiin sovelluksiin tai automaatioihin.

Bearer Token -todennus Reaaliaikaiset webhookit Gmail & Outlook Aliakset JSON-vastaukset
Käyttäjän API Perus-URL HTTPS
Pyynnön muoto Käytä API-avainta vain Authorization Bearer -otsikossa ja pidä päätepisteen URL-osoitteet puhtaina.

Postilaatikon hallinta

Hae sallitut verkkotunnukset, luo tai vaihda postilaatikoita, valitse sallitut käyttöajat ja poista omistamasi osoitteet.

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

Listaa sallitut domainit

Listaa käytettävissä olevat domainit tilapäisten sähköpostien luomista varten. Suodata tyypin mukaan nähdäksesi vain tilauksesi tukemat ilmaiset, premium- tai mukautetut domainit.

Parametrit 1
Parametri Sijainti Tyyppi Tila Kuvaus
type query string valinnainen
Domain-tason suodatin. Jos jätetään pois, käytetään kaikkia, kun premium-domain -pääsy on käytössä, muuten ilmaisia. Tunnistetut arvot: free, basic, pro, premium, custom, ultimate, all
Oletus: Tilistä riippuva
Hae sallitut asioiden luettelot
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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
            }
        ]
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
data.requested_type string
Käytetty toimialuesuodatin.
data.plan string
Nykyisen suunnitelman tunniste.
data.plan_name string
Luettavissa oleva nykyisen suunnitelman nimi.
data.allowed_types array<string>
Tälle tilille saatavilla olevat verkkotunnussuodattimet. Tunnistettu suodatin voi silti olla kielletty suunnitelmassasi.
data.domains array
Valittavat domainit suodatuksen jälkeen; tyhjä taulukko on kelvollinen.
data.domains[].domain string
Valittavissa oleva verkkotunnus.
data.domains[].type string
Luettavissa oleva domain-tason etiketti.
data.domains[].custom boolean
Onko kyseessä mukautettu verkkotunnus.
POST https://v1.tempmailg.com/api/emails
#

Luo tilapäinen postilaatikko

Luo omistettu tilapäinen postilaatikko. Jätä käyttäjänimi ja domain pois satunnaista luontia varten, tai anna sallittu mukautettu käyttäjänimi ja sallittu domain. Provider-parametri voi valita Gmail- tai Outlook-aliaksen luomisen.

Parametrit 8
Parametri Sijainti Tyyppi Tila Kuvaus
username body string valinnainen
Valinnainen mukautettu käyttäjänimi: 2–64 ASCII-merkkiä, kirjaimia, numeroita, pisteitä, alaviivoja tai yhdysviivoja. Vaatii suunnitelmaluvan; custom_username on myös hyväksytty.
Oletus: Satunnaisesti luotu
domain body string valinnainen
Yksi GET /domains -pyynnön palauttamista sallitusta verkkotunnuksesta. Jättäminen valitsee satunnaisen sallitun verkkotunnuksen.
Oletus: Satunnainen sallittu verkkotunnus
lifetime body string valinnainen
sallitut arvot:
10m — 10 minuuttia 1h — 1 Tunti 2h — 2 tuntia 1d — 1 päivä 1w — 7 Päivää 1m — 30 päivää 3m — 90 päivää 6m — 180 päivää 1y — 365 päivää unlimited — Rajaton
Oletus: Suunnitelman oletusikä
provider body string valinnainen
Postilaatikon tarjoaja: standard, gmail_alias tai outlook_alias.
Oletus: standard
pin_enabled body boolean valinnainen
Valinnainen PIN-suojaus uudelle postilaatikolle, jos suunnitelmasi sallii sen. Se ei muuta olemassa olevan postilaatikon PIN-koodia.
Oletus: false
pin body string valinnainen
Vaaditaan, kun pin_enabled on true: 6–8 numeron PIN, lähetetty merkkijonona säilyttääkseen etunollat.
pin_confirmation body string valinnainen
Vaaditaan, kun pin_enabled on true. Täytyy täsmätä tarkalleen piniin.
Idempotency-Key header string valinnainen
Vaaditaan PIN-suojattuun luomiseen tai poistamiseen: vakaa 16–128 merkin avain. Toista identtinen pyyntö samalla avaimella välttääksesi kaksoistyön.
Valinnaiset rungon parametrit: username (muokattu käyttäjänimi, jos suunnitelma sallii), domain (sallittu verkkotunnus, esim. example.com), lifetime (sallitut arvot: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Jätä elinikä pois tai jätä se tyhjäksi, jotta käytetään nykyisen kuukausi-/vuositilauksesi oletus‑sähköpostin elinikää. Lähetä sallittu elinikä, kuten 1h, korvataksesi oletuksen. Rajoittamatonta käytetään vain, kun se on määritetty tilauksen oletukseksi tai se on erikseen pyydetty ja sallittu. Runko-parametrit mailbox_lifetime ja email_lifetime hyväksytään myös; ensimmäinen ei-tyhjä arvo voittaa tässä järjestyksessä: lifetime, mailbox_lifetime, email_lifetime. Virheelliset tai kielletyt arvot palauttavat HTTP 422 sen sijaan, että hiljaisesti valittaisiin oletus.
Luo postilaatikko
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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:02+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:02+00:00",
        "email_token": "encrypted-email-token"
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
data.id integer
Postilaatikon ID. Luodut ID:t, osoitteet ja tokenit eroavat jokaisessa postilaatikossa.
data.pin_protected boolean
Onko tällä postilaatikolla PIN-suojaus. PIN-koodia tai PIN-hashia ei palauteta.
data.email string
Luotu täysi postilaatikon osoite.
data.domain string
Luodun postilaatikon toimialue.
data.provider string
Postilaatikon tarjoaja: standard, gmail_alias tai outlook_alias.
data.expire_at string|null
Voimassa oleva päättymisaika ISO-8601-aikaleimana tai null, jos postilaatikko on rajoittamaton.
data.expires_in_seconds number|null
Laskettuna jäljellä olevat ei‑negatiiviset sekunnit; murto‑sekunnit ovat mahdollisia. Null tarkoittaa rajoittamatonta, ei nollaa.
data.mailbox_state string
Nykyinen postilaatikon tila: aktiivinen, keskeytetty, vanhentunut tai passiivinen.
data.receiving_enabled boolean
Onko tämä postilaatikko tällä hetkellä vastaanottamassa saapuvia viestejä.
data.message_count integer
Tunnettu kokonaisviestimäärä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.unread_message_count integer
Tunnettu lukemattomien viestien määrä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.last_message_received_at string|null
Viimeksi tunnettu vastaanotetun viestin aika ISO-8601-muodossa, tai null jos ei saatavilla.
data.message_count_synced_at string|null
Viimeinen viestimäärän synkronointiaika ISO-8601-muodossa, tai null ennen synkronointia.
data.created_at string|null
Postilaatikon luontiaika ISO-8601-muodossa.
data.email_token string
Epäsuora salattu postilaatikon viite. Se ei korvaa Bearer-todennusta, omistajuustarkistuksia tai PIN-valtuutusta.
data.pin_grant object
Ehdollinen: aktiivinen PIN-suojattu postilaatikon luominen palauttaa tämän lukuoikeuden; tavallinen suojaamaton luominen jättää sen pois.
data.pin_grant.mailbox_id integer
Postilaatikon ID, johon ehdollinen lukuoikeus on sidottu.
data.pin_grant.unlock_token string
Läpinäkymätön luku­merkki X-Mailbox-Unlock -toimintoa varten samalla omistajan tunnuksella. Pidä se yksityisenä ja muistissa; lukuoikeus ei valtuuta poistamista.
data.pin_grant.scope string
Lukualue ehdolliselle luontiluvalle.
data.pin_grant.idle_timeout_seconds integer
Sallittu odotusaika lukuoikeudelle, yleensä 3600 sekuntia.
data.pin_grant.absolute_timeout_seconds integer
Lukuoikeuden enimmäiskesto, yleensä 86400 sekuntia.
data.pin_grant.expires_at string
Nykyinen luku-oikeuden vanhentuminen ISO-8601-muodossa.
data.pin_grant.absolute_expires_at string
Absoluuttinen lukuoikeuden vanhentumisaika ISO-8601-muodossa. Turvallisuusmuutokset voivat peruuttaa oikeuden aikaisemmin.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Päivitä / Vaihda postilaatikko

Luo tai valitse postilaatikko uudessa käyttäjänimessä ja domainissa sen jälkeen, kun nykyisen postilaatikon omistajuus on vahvistettu. Tämä ei nimeä vanhaa postilaatikkoa uudelleen eikä muuta sen käyttöikää paikallisesti. Kun kohde eroaa, vanha postilaatikko säilyy historiassa ja se saattaa pysäyttää aktiivisen postilaatikon rajoitukset. Oman aktiivisen kohteen uudelleenkäyttö asettaa sen pyydetyn käyttöiän tai suunnitelman oletuksen uudelleen.

Parametrit 9
Parametri Sijainti Tyyppi Tila Kuvaus
email path string pakollinen
Omistetun postilaatikon nykyinen täysi sähköpostiosoite vaihdettavaksi. URL-koodaa jokainen polun osa; koodaa plus-merkki %2B.
username path string pakollinen
Uusi haluttu käyttäjänimi: 2-64 alfanumeerista merkkiä; edellyttää mukautettua käyttäjänimen lupaa.
domain path string pakollinen
Uusi sallittu verkkotunnus.
lifetime body string valinnainen
sallitut arvot:
10m — 10 minuuttia 1h — 1 Tunti 2h — 2 tuntia 1d — 1 päivä 1w — 7 Päivää 1m — 30 päivää 3m — 90 päivää 6m — 180 päivää 1y — 365 päivää unlimited — Rajaton
Oletus: Suunnitelman oletusikä
pin_enabled body boolean valinnainen
Valinnainen PIN-suojaus uudelle postilaatikolle, jos suunnitelmasi sallii sen. Se ei muuta olemassa olevan postilaatikon PIN-koodia.
Oletus: false
pin body string valinnainen
Vaaditaan, kun pin_enabled on true: 6–8 numeron PIN, lähetetty merkkijonona säilyttääkseen etunollat.
pin_confirmation body string valinnainen
Vaaditaan, kun pin_enabled on true. Täytyy täsmätä tarkalleen piniin.
Idempotency-Key header string valinnainen
Vaaditaan PIN-suojattuun luomiseen tai poistamiseen: vakaa 16–128 merkin avain. Toista identtinen pyyntö samalla avaimella välttääksesi kaksoistyön.
X-Mailbox-Unlock header string valinnainen
Otsikko, vain suojatut postilaatikot: käytä luku-unlock_tokenia. Lähetä ensin POST pin ja scope=read PIN-unlock-URLiin. Säilytä normaali Bearer-todennus. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Käytä olemassa olevaa omistettua postilaatikon sähköpostiosoitetta {email}: ssä. Valinnainen rungon parametri: lifetime (sallitut arvot: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Jätä elinikä pois tai jätä se tyhjäksi, jotta käytetään nykyisen kuukausi-/vuositilauksesi oletus‑sähköpostin elinikää. Lähetä sallittu elinikä, kuten 1h, korvataksesi oletuksen. Rajoittamatonta käytetään vain, kun se on määritetty tilauksen oletukseksi tai se on erikseen pyydetty ja sallittu. Runko-parametrit mailbox_lifetime ja email_lifetime hyväksytään myös; ensimmäinen ei-tyhjä arvo voittaa tässä järjestyksessä: lifetime, mailbox_lifetime, email_lifetime. Virheelliset tai kielletyt arvot palauttavat HTTP 422 sen sijaan, että hiljaisesti valittaisiin oletus.
Päivitä omistettu postilaatikko
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'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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:02+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:02+00:00",
        "email_token": "encrypted-email-token"
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
data.id integer
Postilaatikon ID. Luodut ID:t, osoitteet ja tokenit eroavat jokaisessa postilaatikossa.
data.pin_protected boolean
Onko tällä postilaatikolla PIN-suojaus. PIN-koodia tai PIN-hashia ei palauteta.
data.email string
Luotu täysi postilaatikon osoite.
data.domain string
Luodun postilaatikon toimialue.
data.provider string
Postilaatikon tarjoaja: standard, gmail_alias tai outlook_alias.
data.expire_at string|null
Voimassa oleva päättymisaika ISO-8601-aikaleimana tai null, jos postilaatikko on rajoittamaton.
data.expires_in_seconds number|null
Laskettuna jäljellä olevat ei‑negatiiviset sekunnit; murto‑sekunnit ovat mahdollisia. Null tarkoittaa rajoittamatonta, ei nollaa.
data.mailbox_state string
Nykyinen postilaatikon tila: aktiivinen, keskeytetty, vanhentunut tai passiivinen.
data.receiving_enabled boolean
Onko tämä postilaatikko tällä hetkellä vastaanottamassa saapuvia viestejä.
data.message_count integer
Tunnettu kokonaisviestimäärä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.unread_message_count integer
Tunnettu lukemattomien viestien määrä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.last_message_received_at string|null
Viimeksi tunnettu vastaanotetun viestin aika ISO-8601-muodossa, tai null jos ei saatavilla.
data.message_count_synced_at string|null
Viimeinen viestimäärän synkronointiaika ISO-8601-muodossa, tai null ennen synkronointia.
data.created_at string|null
Postilaatikon luontiaika ISO-8601-muodossa.
data.email_token string
Epäsuora salattu postilaatikon viite. Se ei korvaa Bearer-todennusta, omistajuustarkistuksia tai PIN-valtuutusta.
data.pin_grant object
Ehdollinen: aktiivinen PIN-suojattu postilaatikon luominen palauttaa tämän lukuoikeuden; tavallinen suojaamaton luominen jättää sen pois.
data.pin_grant.mailbox_id integer
Postilaatikon ID, johon ehdollinen lukuoikeus on sidottu.
data.pin_grant.unlock_token string
Läpinäkymätön luku­merkki X-Mailbox-Unlock -toimintoa varten samalla omistajan tunnuksella. Pidä se yksityisenä ja muistissa; lukuoikeus ei valtuuta poistamista.
data.pin_grant.scope string
Lukualue ehdolliselle luontiluvalle.
data.pin_grant.idle_timeout_seconds integer
Sallittu odotusaika lukuoikeudelle, yleensä 3600 sekuntia.
data.pin_grant.absolute_timeout_seconds integer
Lukuoikeuden enimmäiskesto, yleensä 86400 sekuntia.
data.pin_grant.expires_at string
Nykyinen luku-oikeuden vanhentuminen ISO-8601-muodossa.
data.pin_grant.absolute_expires_at string
Absoluuttinen lukuoikeuden vanhentumisaika ISO-8601-muodossa. Turvallisuusmuutokset voivat peruuttaa oikeuden aikaisemmin.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Poista postilaatikko

Poista omistettu postilaatikko ja käynnistä sen viestien ja tiedostojen puhdistus. Säilytetyt postilaatikkotiedot voidaan poistaa pehmeästi sisäisesti; osoite ei ole enää käytettävissä API:n kautta.

Parametrit 3
Parametri Sijainti Tyyppi Tila Kuvaus
email path string pakollinen
Poistettavan omistetun postilaatikon koko sähköpostiosoite. URL-koodaa osoite; koodaa plus-merkki muodossa %2B.
X-Mailbox-Unlock header string valinnainen
Otsikko, vain suojatut postilaatikot: käytä kertakäyttöistä poistotunnusta unlock_token. Ensin POST pin, scope=delete ja action/target_id, jonka 423 response palauttaa PIN unlock URL:iin. Luku‑token ei voi poistaa. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string valinnainen
Vaaditaan PIN-suojattuun luomiseen tai poistamiseen: vakaa 16–128 merkin avain. Toista identtinen pyyntö samalla avaimella välttääksesi kaksoistyön.
Poista omistettu postilaatikko
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
message string
Poistamisen tulos. Puuttuva resurssi palauttaa HTTP 404.

Gmail & Outlook Aliakset

Luo korkean maineen Gmail- ja Outlook/Hotmail-aliaskäyttäjätiloja.

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

Luo Gmail-aliaksen

Luo uusi Gmail-aliaksen tilapäinen postilaatikko, jonka omistaja on todennettu käyttäjä.

Parametrit 8
Parametri Sijainti Tyyppi Tila Kuvaus
mode body string valinnainen
Luontitila: auto, dot, plus tai plus_dot. Hyväksyy myös gmail_alias_mode. Jos tyylin valinta ei ole sallittu, käytetään autoa.
Oletus: auto
username body string valinnainen
Valinnainen mukautettu alias-pääte: 2–32 ASCII-merkkiä tai numeroa, normalisoitu pieniksi kirjaimiksi; edellyttää ominaisuuden lupaa. Hyväksyy myös custom_username tai alias_username.
Oletus: Automaattisesti luotu
domain body string valinnainen
Käytä satunnaista, gmail.com tai googlemail.com; alias_domain on myös hyväksytty. Jos jätetään pois tai domain‑valintaoikeus ei ole saatavilla, käytetään satunnaista.
Oletus: random
lifetime body string valinnainen
sallitut arvot:
10m — 10 minuuttia 1h — 1 Tunti 2h — 2 tuntia 1d — 1 päivä 1w — 7 Päivää 1m — 30 päivää 3m — 90 päivää 6m — 180 päivää 1y — 365 päivää unlimited — Rajaton
Oletus: Suunnitelman oletusikä
pin_enabled body boolean valinnainen
Valinnainen PIN-suojaus uudelle postilaatikolle, jos suunnitelmasi sallii sen. Se ei muuta olemassa olevan postilaatikon PIN-koodia.
Oletus: false
pin body string valinnainen
Vaaditaan, kun pin_enabled on true: 6–8 numeron PIN, lähetetty merkkijonona säilyttääkseen etunollat.
pin_confirmation body string valinnainen
Vaaditaan, kun pin_enabled on true. Täytyy täsmätä tarkalleen piniin.
Idempotency-Key header string valinnainen
Vaaditaan PIN-suojattuun luomiseen tai poistamiseen: vakaa 16–128 merkin avain. Toista identtinen pyyntö samalla avaimella välttääksesi kaksoistyön.
Vaatii, että Gmail Alias API -lupa on otettu käyttöön tilauspaketissasi tai avattu API-krediittipaketin kautta. Valinnaiset parametrit: mode (auto, dot, plus, plus_dot), username (muokattu alias-käyttäjänimi), domain (esim. gmail.com, googlemail.com), lifetime (sallitut arvot: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Jätä elinikä pois tai jätä se tyhjäksi, jotta käytetään nykyisen kuukausi-/vuositilauksesi oletus‑sähköpostin elinikää. Lähetä sallittu elinikä, kuten 1h, korvataksesi oletuksen. Rajoittamatonta käytetään vain, kun se on määritetty tilauksen oletukseksi tai se on erikseen pyydetty ja sallittu. Runko-parametrit mailbox_lifetime ja email_lifetime hyväksytään myös; ensimmäinen ei-tyhjä arvo voittaa tässä järjestyksessä: lifetime, mailbox_lifetime, email_lifetime. Virheelliset tai kielletyt arvot palauttavat HTTP 422 sen sijaan, että hiljaisesti valittaisiin oletus.
Luo Gmail-aliaspostilaatikko
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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:02+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:02+00:00",
        "email_token": "encrypted-email-token"
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
data.id integer
Postilaatikon ID. Luodut ID:t, osoitteet ja tokenit eroavat jokaisessa postilaatikossa.
data.pin_protected boolean
Onko tällä postilaatikolla PIN-suojaus. PIN-koodia tai PIN-hashia ei palauteta.
data.email string
Luotu täysi postilaatikon osoite.
data.domain string
Luodun postilaatikon toimialue.
data.provider string
Postilaatikon tarjoaja: standard, gmail_alias tai outlook_alias.
data.expire_at string|null
Voimassa oleva päättymisaika ISO-8601-aikaleimana tai null, jos postilaatikko on rajoittamaton.
data.expires_in_seconds number|null
Laskettuna jäljellä olevat ei‑negatiiviset sekunnit; murto‑sekunnit ovat mahdollisia. Null tarkoittaa rajoittamatonta, ei nollaa.
data.mailbox_state string
Nykyinen postilaatikon tila: aktiivinen, keskeytetty, vanhentunut tai passiivinen.
data.receiving_enabled boolean
Onko tämä postilaatikko tällä hetkellä vastaanottamassa saapuvia viestejä.
data.message_count integer
Tunnettu kokonaisviestimäärä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.unread_message_count integer
Tunnettu lukemattomien viestien määrä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.last_message_received_at string|null
Viimeksi tunnettu vastaanotetun viestin aika ISO-8601-muodossa, tai null jos ei saatavilla.
data.message_count_synced_at string|null
Viimeinen viestimäärän synkronointiaika ISO-8601-muodossa, tai null ennen synkronointia.
data.created_at string|null
Postilaatikon luontiaika ISO-8601-muodossa.
data.email_token string
Epäsuora salattu postilaatikon viite. Se ei korvaa Bearer-todennusta, omistajuustarkistuksia tai PIN-valtuutusta.
data.pin_grant object
Ehdollinen: aktiivinen PIN-suojattu postilaatikon luominen palauttaa tämän lukuoikeuden; tavallinen suojaamaton luominen jättää sen pois.
data.pin_grant.mailbox_id integer
Postilaatikon ID, johon ehdollinen lukuoikeus on sidottu.
data.pin_grant.unlock_token string
Läpinäkymätön luku­merkki X-Mailbox-Unlock -toimintoa varten samalla omistajan tunnuksella. Pidä se yksityisenä ja muistissa; lukuoikeus ei valtuuta poistamista.
data.pin_grant.scope string
Lukualue ehdolliselle luontiluvalle.
data.pin_grant.idle_timeout_seconds integer
Sallittu odotusaika lukuoikeudelle, yleensä 3600 sekuntia.
data.pin_grant.absolute_timeout_seconds integer
Lukuoikeuden enimmäiskesto, yleensä 86400 sekuntia.
data.pin_grant.expires_at string
Nykyinen luku-oikeuden vanhentuminen ISO-8601-muodossa.
data.pin_grant.absolute_expires_at string
Absoluuttinen lukuoikeuden vanhentumisaika ISO-8601-muodossa. Turvallisuusmuutokset voivat peruuttaa oikeuden aikaisemmin.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlookin alias-alueet

Hae aktiiviset Outlook / Hotmail aliaksen verkkotunnukset, jotka ovat käytettävissä postilaatikon luomiseen.

Vaatii Outlook Alias API -oikeuden, joka on otettava käyttöön tilauspaketissasi tai avattava API-krediittipaketilla. Ilmaisee, onko tiettyjen verkkotunnusten valinta avattu suunnitelmassasi.
Hae Outlook‑alias‑verkkotunnukset
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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
            }
        ]
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
data.domains array
Aktiiviset Outlook/Hotmail-verkkotunnukset; tyhjä taulukko on kelvollinen.
data.domains[].domain string
Saatavilla oleva verkkotunnus.
data.domains[].type string
Luettavissa oleva tarjoajan tunniste.
data.domains[].selectable boolean
Voiko tilisi valita tämän domainin nimenomaisesti.
data.domains[].locked boolean
Onko eksplisiittinen domain‑valinta lukittu tilillesi.
data.domains[].disabled_reason string|null
Syy, miksi verkkotunnuksen valinta on lukittu, tai null, kun se on valittavissa.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Luo Outlook-aliaksen

Luo uusi Outlook / Hotmail -alias, tilapäinen postilaatikko, jonka omistajana on todennettu käyttäjä.

Parametrit 7
Parametri Sijainti Tyyppi Tila Kuvaus
domain body string valinnainen
Käytä satunnaista tai verkkotunnusta GET /outlook-alias/domains; outlook_alias_domain on myös hyväksytty. Ilman valintaoikeutta käytetään satunnaista.
Oletus: Satunnainen käytettävissä oleva domain
username body string valinnainen
Valinnainen mukautettu alias-pääte: 2–32 ASCII-merkkiä tai numeroa, normalisoitu pieniksi kirjaimiksi; edellyttää ominaisuuden lupaa. Hyväksyy myös custom_username tai alias_username.
Oletus: Automaattisesti luotu
lifetime body string valinnainen
sallitut arvot:
10m — 10 minuuttia 1h — 1 Tunti 2h — 2 tuntia 1d — 1 päivä 1w — 7 Päivää 1m — 30 päivää 3m — 90 päivää 6m — 180 päivää 1y — 365 päivää unlimited — Rajaton
Oletus: Suunnitelman oletusikä
pin_enabled body boolean valinnainen
Valinnainen PIN-suojaus uudelle postilaatikolle, jos suunnitelmasi sallii sen. Se ei muuta olemassa olevan postilaatikon PIN-koodia.
Oletus: false
pin body string valinnainen
Vaaditaan, kun pin_enabled on true: 6–8 numeron PIN, lähetetty merkkijonona säilyttääkseen etunollat.
pin_confirmation body string valinnainen
Vaaditaan, kun pin_enabled on true. Täytyy täsmätä tarkalleen piniin.
Idempotency-Key header string valinnainen
Vaaditaan PIN-suojattuun luomiseen tai poistamiseen: vakaa 16–128 merkin avain. Toista identtinen pyyntö samalla avaimella välttääksesi kaksoistyön.
Vaatii Outlook Alias API -oikeuden, joka on otettava käyttöön tilauspaketissasi tai avattava API-krediittipaketilla. Valinnaiset parametrit: domain (esim. outlook.com, hotmail.com), username (muokattu alias-käyttäjänimi), lifetime (sallitut arvot: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Jätä elinikä pois tai jätä se tyhjäksi, jotta käytetään nykyisen kuukausi-/vuositilauksesi oletus‑sähköpostin elinikää. Lähetä sallittu elinikä, kuten 1h, korvataksesi oletuksen. Rajoittamatonta käytetään vain, kun se on määritetty tilauksen oletukseksi tai se on erikseen pyydetty ja sallittu. Runko-parametrit mailbox_lifetime ja email_lifetime hyväksytään myös; ensimmäinen ei-tyhjä arvo voittaa tässä järjestyksessä: lifetime, mailbox_lifetime, email_lifetime. Virheelliset tai kielletyt arvot palauttavat HTTP 422 sen sijaan, että hiljaisesti valittaisiin oletus.
Luo Outlook-aliaspostilaatikko
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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:02+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:02+00:00",
        "email_token": "encrypted-email-token"
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
data.id integer
Postilaatikon ID. Luodut ID:t, osoitteet ja tokenit eroavat jokaisessa postilaatikossa.
data.pin_protected boolean
Onko tällä postilaatikolla PIN-suojaus. PIN-koodia tai PIN-hashia ei palauteta.
data.email string
Luotu täysi postilaatikon osoite.
data.domain string
Luodun postilaatikon toimialue.
data.provider string
Postilaatikon tarjoaja: standard, gmail_alias tai outlook_alias.
data.expire_at string|null
Voimassa oleva päättymisaika ISO-8601-aikaleimana tai null, jos postilaatikko on rajoittamaton.
data.expires_in_seconds number|null
Laskettuna jäljellä olevat ei‑negatiiviset sekunnit; murto‑sekunnit ovat mahdollisia. Null tarkoittaa rajoittamatonta, ei nollaa.
data.mailbox_state string
Nykyinen postilaatikon tila: aktiivinen, keskeytetty, vanhentunut tai passiivinen.
data.receiving_enabled boolean
Onko tämä postilaatikko tällä hetkellä vastaanottamassa saapuvia viestejä.
data.message_count integer
Tunnettu kokonaisviestimäärä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.unread_message_count integer
Tunnettu lukemattomien viestien määrä; se voi heijastaa viimeisintä postilaatikon synkronointia.
data.last_message_received_at string|null
Viimeksi tunnettu vastaanotetun viestin aika ISO-8601-muodossa, tai null jos ei saatavilla.
data.message_count_synced_at string|null
Viimeinen viestimäärän synkronointiaika ISO-8601-muodossa, tai null ennen synkronointia.
data.created_at string|null
Postilaatikon luontiaika ISO-8601-muodossa.
data.email_token string
Epäsuora salattu postilaatikon viite. Se ei korvaa Bearer-todennusta, omistajuustarkistuksia tai PIN-valtuutusta.
data.pin_grant object
Ehdollinen: aktiivinen PIN-suojattu postilaatikon luominen palauttaa tämän lukuoikeuden; tavallinen suojaamaton luominen jättää sen pois.
data.pin_grant.mailbox_id integer
Postilaatikon ID, johon ehdollinen lukuoikeus on sidottu.
data.pin_grant.unlock_token string
Läpinäkymätön luku­merkki X-Mailbox-Unlock -toimintoa varten samalla omistajan tunnuksella. Pidä se yksityisenä ja muistissa; lukuoikeus ei valtuuta poistamista.
data.pin_grant.scope string
Lukualue ehdolliselle luontiluvalle.
data.pin_grant.idle_timeout_seconds integer
Sallittu odotusaika lukuoikeudelle, yleensä 3600 sekuntia.
data.pin_grant.absolute_timeout_seconds integer
Lukuoikeuden enimmäiskesto, yleensä 86400 sekuntia.
data.pin_grant.expires_at string
Nykyinen luku-oikeuden vanhentuminen ISO-8601-muodossa.
data.pin_grant.absolute_expires_at string
Absoluuttinen lukuoikeuden vanhentumisaika ISO-8601-muodossa. Turvallisuusmuutokset voivat peruuttaa oikeuden aikaisemmin.

Viestit ja liitteet

Nouda saapuvat postilaatikot, lue täysi HTML-/tekstiviestit ja suoratoista liitteet.

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

Listaa postilaatikon viestit

Hae käytettävissä olevat viestitiivistelmät ja postilaatikon metadata. Standardi postilaatikon skannaukset palauttavat viimeisimmän erän, jossa on enintään 25 viestiä; tämä ei ole sivutettu koko historian päätepiste. Käytä GET /messages/{messageId} saadaksesi täyden sisällön ja liitteet.

Parametrit 2
Parametri Sijainti Tyyppi Tila Kuvaus
email query string pakollinen
Omistetun postilaatikon täydellinen sähköpostiosoite, josta viestejä luetaan. URL-koodaa kyselyarvo; koodaa plus-merkki %2B.
X-Mailbox-Unlock header string valinnainen
Otsikko, vain suojatut postilaatikot: käytä luku-unlock_tokenia. Lähetä ensin POST pin ja scope=read PIN-unlock-URLiin. Säilytä normaali Bearer-todennus. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Sähköpostin on kuuluttava tilillesi. Standard- ja Gmail-yhteenvedot sisältävät OTP- ja verification-link -kenttiä; Outlook sisältää myös from_name-, snippet-, received_at- ja has_attachments -kentät. Palveluntarjoajan synkronointi ja välimuisti voivat viivästyttää uusia viestejä ja määriä.
Lue postilaatikon viestit
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'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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:02",
            "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:02+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:02+00:00",
    "message_count_synced_at": "2026-11-19T02:18:02+00:00"
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
mailbox string
Postilaatikon osoite, jonka viestejä pyydettiin.
email_token string
Läpinäkymätön salattu postilaatikkoviite; normaali todennus on edelleen vaadittu.
mailbox_provider string
Postilaatikon tarjoaja: standard, gmail_alias tai outlook_alias.
messages array
Viestiyhteenvedot. Tyhjä postilaatikko palauttaa tyhjän taulukon; hae yksi viesti sen sisällön ja liitteiden saamiseksi.
expire_at string|null
Voimassa oleva päättymisaika ISO-8601-aikaleimana tai null, jos postilaatikko on rajoittamaton.
expires_in_seconds number|null
Laskettuna jäljellä olevat ei‑negatiiviset sekunnit; murto‑sekunnit ovat mahdollisia. Null tarkoittaa rajoittamatonta, ei nollaa.
mailbox_state string
Nykyinen postilaatikon tila: aktiivinen, keskeytetty, vanhentunut tai passiivinen.
receiving_enabled boolean
Onko tämä postilaatikko tällä hetkellä vastaanottamassa saapuvia viestejä.
message_count integer
Tunnettu kokonaisviestimäärä; se voi heijastaa viimeisintä postilaatikon synkronointia.
unread_message_count integer
Tunnettu lukemattomien viestien määrä; se voi heijastaa viimeisintä postilaatikon synkronointia.
last_message_received_at string|null
Viimeksi tunnettu vastaanotetun viestin aika ISO-8601-muodossa, tai null jos ei saatavilla.
message_count_synced_at string|null
Viimeinen viestimäärän synkronointiaika ISO-8601-muodossa, tai null ennen synkronointia.
mailbox_limit.limit integer
Tämän palveluntarjoajan aktiivinen postilaatikkoraja; -1 tarkoittaa rajoittamatonta.
mailbox_limit.limit_label string
Näyttötunniste postilaatinon rajoitukselle.
mailbox_limit.active_count integer
Tämän tarjoajan aktiivisten postilaatikoiden määrä.
mailbox_limit.paused_count integer
Tämän tarjoajan tauotettujen postilaatikoiden määrä.
mailbox_limit.paused_mailboxes array<string>
Osoitteet on keskeytetty postilaatikon rajan vuoksi.
mailbox_limit.remaining integer
Jäljellä olevat aktiiviset postilaatikkopaikat; -1 tarkoittaa rajoittamatonta. Tämä ei ole API-pyyntöjen kiintiö.
mailbox_limit.remaining_label string
Näytä merkintä jäljellä olevista postilaatikon paikoista.
mailbox_limit.reached boolean
Onko aktiivinen postilaatikkoraja saavutettu.
mailbox_limit.blocked boolean
Onko aktiivinen postilaatin raja nolla.
mailbox_limit.provider string|null
Palveluntarjoaja, johon postilaatikon raja kohdistuu.
messages[].id string
Epäsuora viestitunnus, jota käytetään yksittäisen viestin, poistamisen ja liitteen päätepisteissä.
messages[].is_seen boolean
Onko viesti merkitty luetuksi.
messages[].subject string
Viestin aihe.
messages[].from string
Lähettäjän näyttönimi tai osoite.
messages[].from_email string
Lähettäjän sähköpostiosoite.
messages[].receivedAt string
Vastaanottoaika sovelluksen aikavyöhykkeessä, muotoiltu muodossa YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Havaittu kertakäyttökoodi, kun se on saatavilla ja sallittu; muuten null.
messages[].otp_locked boolean
Onko havaittu kertakäyttökoodi piilotettu ominaisuuksien käyttöoikeuksilla.
messages[].verification_link string|null
Havaittu vahvistus-URL, kun se on saatavilla ja sallittu; muuten null.
messages[].verification_link_locked boolean
Onko havaittu vahvistuslinkki piilotettu ominaisuuksien käyttöoikeuksilla.
messages[].from_name string|null
Outlook-yhteenvedon kenttä: alkuperäisen lähettäjän nimi. Puuttuu Standard- ja Gmail-yhteenvedosta.
messages[].snippet string|null
Outlook-yhteenvedon kenttä: lyhyt viestin esikatselu.
messages[].received_at string|null
Outlook-yhteenvedon kenttä: ISO-8601 vastaanottoaika, kun tiedossa.
messages[].has_attachments boolean
Outlookin yhteenvetokenttä: onko liitetiedoston metatiedot olemassa. Latauksen saatavuus tarkistetaan erikseen.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Hae yksittäinen viesti

Hae omistettu viesti sen epäsuoralla viesti-ID:llä. Palauttaa rungon muodot ja liitteiden metatiedot. Rungon kentät riippuvat viestin muodosta; Outlook lisää alla luetellut toimittajakohtaiset kentät.

Parametrit 2
Parametri Sijainti Tyyppi Tila Kuvaus
messageId path string pakollinen
Ainutlaatuinen viestin tunniste, joka palautetaan viestilistassa.
X-Mailbox-Unlock header string valinnainen
Otsikko, vain suojatut postilaatikot: käytä luku-unlock_tokenia. Lähetä ensin POST pin ja scope=read PIN-unlock-URLiin. Säilytä normaali Bearer-todennus. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Lue yksi viesti
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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:02",
        "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"
            }
        ]
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
data.id string
Epäsuora viestin ID.
data.is_seen boolean
Viestin luetun tila. Lukeminen voi merkitä sen nähdyksi; välimuistissa oleva data voi heijastaa aikaisempaa tilaa.
data.subject string
Viestin aihe.
data.from string
Lähettäjän näyttönimi tai osoite.
data.from_email string
Lähettäjän sähköpostiosoite.
data.to string
Vastaanottajan postilaatikon osoite.
data.mailbox_provider string
Postilaatikon tarjoaja: standard, gmail_alias tai outlook_alias.
data.receivedAt string
Vastaanottoaika sovelluksen aikavyöhykkeessä, muotoiltu muodossa YYYY-MM-DD HH:mm:ss.
data.html boolean
Onko viestissä HTML-runko.
data.html_content string
HTML-runko, kun se on läsnä. Tavalliset viestit ilman HTML:ää voivat jättää tämän kentän pois. Käsittele viestin sisältöä epäluotettavana.
data.text_content string
Tekstirunko, jos se on läsnä; Vakioviestit saattavat sisältää pakatun tekstin pre-elementissä tai jättää tämän kentän pois.
data.content string
Ensisijainen sisältö näytettäväksi, yleensä HTML kun saatavilla.
data.attachments array
Liitteen metatiedot tai tyhjä taulukko. Lataukset vaativat normaalin todennuksen ja soveltuvan PIN‑valtuutuksen.
data.attachments[].name string
Tiedostonimi URL-koodattavaksi yhtenä polkuosana ladattaessa.
data.attachments[].size integer
Liitteen koko tavuina.
data.attachments[].url string
Todennettu käyttäjän API:n lataus-URL lisätty liitteisiin tiedostonimellä. URL ei takaa, että paikallinen tiedosto on saatavilla.
data.attachments[].extension string
Standardi/Gmail-metatietokenttä: tiedostopääte, jos annettu.
data.attachments[].id string
Outlookin metatietokenttä: palveluntarjoajan liitetunnus.
data.attachments[].content_type string
Outlookin metatietokenttä: MIME-sisältötyyppi.
data.from_name string|null
Outlookin yksityiskohtakenttä: alkuperäisen lähettäjän nimi.
data.to_email string|null
Outlookin yksityiskenttä: alkuperäisen vastaanottajan osoite.
data.received_at string|null
Outlookin yksityiskenttä: ISO-8601 vastaanottoaika.
data.has_html boolean
Outlookin yksityiskenttä: onko HTML-runko olemassa.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Poista viesti

Poista yksi omistettu viesti

Parametrit 3
Parametri Sijainti Tyyppi Tila Kuvaus
messageId path string pakollinen
Ainutlaatuinen viestin ID-merkkijono pysyvästi poistettavaksi.
X-Mailbox-Unlock header string valinnainen
Otsikko, vain suojatut postilaatikot: käytä kertakäyttöistä poistotunnusta unlock_token. Ensin POST pin, scope=delete ja action/target_id, jonka 423 response palauttaa PIN unlock URL:iin. Luku‑token ei voi poistaa. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string valinnainen
Vaaditaan PIN-suojattuun luomiseen tai poistamiseen: vakaa 16–128 merkin avain. Toista identtinen pyyntö samalla avaimella välttääksesi kaksoistyön.
Poista yksi viesti
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Vastauskentät
Kenttä Tyyppi Kuvaus
status boolean
Onko operaatio onnistunut.
message string
Poistamisen tulos. Puuttuva resurssi palauttaa HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Lataa liite

Lataa liite omistetusta viestistä.

Parametrit 3
Parametri Sijainti Tyyppi Tila Kuvaus
messageId path string pakollinen
Tiedoston sisältävän viestin ID.
filename path string pakollinen
Liitetiedoston tiedostonimi ja tiedostopääte ladattavaksi.
X-Mailbox-Unlock header string valinnainen
Otsikko, vain suojatut postilaatikot: käytä luku-unlock_tokenia. Lähetä ensin POST pin ja scope=read PIN-unlock-URLiin. Säilytä normaali Bearer-todennus. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Onnistuminen palauttaa tiedoston tavut, ei JSONia. Ylisuuret tiedostot palauttavat HTTP 403; puuttuvat tai ei‑käytettävissä olevat paikalliset tiedostot palauttavat HTTP 404. URL‑koodaa tiedostonimi yhtenä polkuosana. Liitteen metatiedot eivät yksin takaa latauksen saatavuutta.
Lataa liite
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
Latauskaulu Tämä päätepiste palauttaa pyydetyän tiedoston suoraan JSON-runkoa vastaan.
Vastauskentät
Kenttä Tyyppi Kuvaus
Content-Disposition header
Onnistunut vastaus lataa pyydetyn tiedostonimen.
body binary
Tiedoston tavut onnistumisessa, ei JSON. Virheet palauttavat JSON:n, jossa on ei-2xx-tila.

Ratelimitit & Kiintiöt

Seuraa reaaliaikaisia pyyntöbudjetteja, nopeusrajoituksia ja tilin kiintiöitä kuluttamatta krediittejä.

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

Nopeusrajoitus ja kiintiö

Tarkista nykyinen nopeusraja ja kiintiön tila kuluttamatta API-käyttöä. Tämä päätepiste on kiintiötön eikä vähennä kuukausittaisia API-kynttejä (käytön väärinkäytön suojausraja: 60 pyyntöä/min).

X-RateLimit-* kuvaa ilmoitettua pyyntöbudjettia; X-Quota-* kuvaa kuukausittaista ja ostettua kapasiteettia, kun saatavilla. X-Mailbox-RateLimit-* raportoi erillisen postilaatikon luonti/päivitysbudjetin. Postilaatikkoon rajoittuva hylkäys käyttää postilaatikon laajuutta ja omaa uudelleenyritysikkunaa. Minuutin rajoituksen hylkäykset voivat jättää quota-tiedot pois. Retry-After sisällytetään vain aikarajoitetulle uudelleenyritykselle; poistettu pääsy saattaa vaatia tilin muutoksen. Tässä onnistuneessa tilavastauksessa data.limit, data.remaining ja data.reset kuvaavat tilin minuuttibudjettia, eivätkä käytettävissä olevia krediittejä. data.quota-objekti kuvaa kuukausittaista sallittua määrää, krediittisaldoja ja käyttöä. Olemassa olevat data.monthly_limit, data.monthly_remaining ja data.purchased_credits -kentät pysyvät vastaavien quota-kenttien aliaksina. Onnistunut tilatarkistus ei valtuuta toista API-toimintoa. Toiminnot edellyttävät edelleen käytössä olevaa pääsyä, saatavilla olevaa kiintiötä ja hyväksyntää kaikkien sovellettavien rajoitusten läpi. Kiintiötilannekuva ei takaa jo keskeneräisen pyynnön varattua kapasiteettia.
Tarkista rajoitusrajan tila
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Kuvitteellinen vastaus käyttäen synteettisiä tietoja. ID:t, osoitteet, tokenit, aikaleimat, suunnitelman rajoitukset ja määrät vaihtelevat. Esimerkkielinikä ei korvaa suunnitelmasi oletusta. Vastauskenttien kuvaukset tunnistavat null-arvot ja toimittajakohtaiset kentät.

Esimerkki vastaus
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"
        }
    }
}
Vastauskentät
Kenttä Tyyppi Kuvaus
data.limit integer|string
Tilin pyyntöjen per minuutti -raja. Merkkijono unlimited tarkoittaa rajoittamatonta minuutin budjettia; tämä on riippumaton kuukausittaisesta kiintiöstä.
data.remaining integer|string
Jäljellä olevat tilin minuuttibudjetin paikat, tai merkkijono unlimited. Positiivinen arvo ei tarkoita, että API‑krediittejä on jäljellä.
data.reset integer
Sekunnit tilin minuutti-ikkunalle, ei kuukausittaisen kiintiön nollaukselle. Poistettu tai rajoittamaton minuuttibudjetti voi säilyttää nimellisesti 60 sekunnin arvon; tämä ei takaa pääsyä odottamisen jälkeen.
data.plan string
Nykyinen suunnitelmatunniste. Luettavissa oleva suunnitelman nimi annetaan erikseen kohteessa data.quota.plan_name.
data.quota.enabled boolean
Onko globaali ja suunnitelma/luotto-API-pääsy käytössä. Tämä ei kerro jäljellä olevaa kapasiteettia eikä korvaa käyttäjän API-kytkintä.
data.quota.user_api_status boolean
Onko käyttäjä ottanut käyttöön User API -kytkimen. Toiminnot vaativat tämän kytkimen sekä käytössä olevan pääsyn ja saatavilla olevan kapasiteetin.
data.quota.plan_name string
Luettavissa oleva nykyisen suunnitelman nimi.
data.quota.period string
Kalenterikuukauden käyttöjakso YYYY-MM -muodossa, käyttäen sovelluksen aikavyöhykettä; ei välttämättä tilauksen laskutusjaksoa.
data.quota.base_limit integer
Peruskuukausittainen suunnitelman sallittu määrä. Arvo -1 tarkoittaa rajoittamatonta.
data.quota.extra_requests integer
Lisäkuukausittainen kiintiö myönnetty nykyiselle käyttökaudelle; erillinen ostetuista krediiteistä.
data.quota.monthly_limit integer
Peruskiintiö plus nykyisen kauden lisäpyynnöt. Arvo -1 tarkoittaa rajoittamatonta. Ostetut krediitit eivät sisälly.
data.quota.monthly_remaining integer|null
Jäljellä oleva rajoitettu kuukausittainen sallittu määrä, tai null kun kuukausikiintiö on rajoittamaton. Nullia ei saa tulkita nollaksi.
data.quota.used integer
Onnistuneet, lasketut API-toiminnot nykyisen käyttöjakson aikana, mukaan lukien krediittejä käyttävät toiminnot. Tilannetarkistukset eivät kasvata tätä arvoa.
data.quota.purchased_credits integer
Nykyinen krediittisaldo, mukaan lukien aktiivisen suunnitelman bonuskrediitit. Bonuskrediittejä ei saa lisätä tähän saldoon toisen kerran.
data.quota.bonus_credits integer
Aktiivinen suunnitelman bonuksen osuus krediittisaldosta; purchased_credits:n erittely, ei lisäkapasiteettia.
data.quota.direct_purchased_credits integer
Krediittisaldo ilman aktiivisen suunnitelman bonuksen osuutta. Tämä arvo plus bonus_credits on yhtä kuin purchased_credits.
data.quota.remaining integer|null
Kuukausittainen jäljellä oleva sallittu määrä plus nykyinen krediittitasapaino, ilman bonusten kaksinkertaista laskemista. Null tarkoittaa rajoittamatonta kuukausikiintiötä. Yksittäiset ominaisuusluvat ja muut pyyntörajat pätevät edelleen.
data.quota.unlimited boolean
Onko kuukausikiintiö rajoittamaton. Tämä ei tee tilin minuuttibudjettia tai muiden ominaisuuksien rajoja rajoittamattomiksi.
data.quota.usage_percent integer
Dashboard-yhteensopiva pyöristetty prosentti 0–100: käytetty jaettuna (käytetty + jäljellä oleva), kerrottuna 100:lla. Se sisältää käytettävissä olevan luottokapasiteetin, joten lataaminen voi alentaa prosenttia. Se on 0, jos on rajoittamaton kiintiö tai nollakokoinen varanto; se ei ole minuutin nopeusrajoituksen prosentti eikä pääsypäätös.
data.quota.reset_at string
ISO-8601-aikaleima aikavyöhykkeen siirtymällä seuraavan kalenterikuukauden kiintiön nollaukseen. Tämä ei ole tilauksen päättymispäivä, eikä kuukausittainen nollaus täydennä ostettuja krediittejä.
status string
Kirjaimellinen onnistuminen tälle tilapisteelle. Muut onnistuneet postilaatikon päätepisteet käyttävät totuusarvoa true.
data.monthly_limit integer
Yhteensopivuusalias vastaavalle data.quota -kentälle; älä lisää sitä uudelleen laskettaessa saldoja.
data.monthly_remaining integer|null
Yhteensopivuusalias vastaavalle data.quota -kentälle; älä lisää sitä uudelleen laskettaessa saldoja.
data.purchased_credits integer
Yhteensopivuusalias vastaavalle data.quota -kentälle; älä lisää sitä uudelleen laskettaessa saldoja.

Postilaatikon PIN-suojaus

Syötä PIN jatkaaksesi. Postilaatikkosi pysyy avattuna, kun se on voimassa tässä verkkosivuston istunnossa.

Hyväksytkö evästeet?

Käytämme evästeitä parantamaan selauskokemustasi. Käyttämällä tätä sivustoa, hyväksyt evästekäytäntömme.

Lue evästeet