TempMail API-dokumentasjon

REST API v1 & Webhooks

TempMailg Utvikler API-dokumentasjon

Bruk denne dokumentasjonen for Ä generere din personlige API-nÞkkel, koble til dedikert bruker-API-vert, lese postboks-meldinger, hÄndtere eide postbokser og integrere Temp Mail i dine egne apper eller automatiseringer.

Bearer Token-autentisering Sanntids-webhooks Gmail og Outlook-aliaser JSON-svar
Bruker API-basen-URL HTTPS
Fostring format Bruk din API-nĂžkkel bare i Autorisasjons Bearer-header og hold endpoint-URL-er rene.

Postboksadministrasjon

Hent tillatte domener, opprett eller bytt postbokser, velg tillatte levetider, og slett eide adresser.

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

List opp tillatte domener

List opp tilgjengelige domener for Ă„ opprette midlertidige e‑poster. Filtrer etter type for kun Ă„ se gratis, premium eller tilpassede domener som stĂžttes av abonnementet ditt.

Parametere 1
Parameter Sted Type Status Beskrivelse
type query string valgfri
Domene-nivÄfilter. Utelatelse bruker alle nÄr premium-domene tilgang er aktivert, ellers gratis. Gjenkjente verdier: free, basic, pro, premium, custom, ultimate, all
Standard: Kontoavhengig
FĂ„ tillatte domener
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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
            }
        ]
    }
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
data.requested_type string
PÄfÞrt domenefilter.
data.plan string
NÄvÊrende planetikett.
data.plan_name string
Lesbart navn pÄ gjeldende plan.
data.allowed_types array<string>
Domene-filtre tilgjengelig for denne kontoen. Et gjenkjent filter kan fortsatt vĂŠre forbudt for din plan.
data.domains array
Valgbare domener etter filtrering; en tom array er gyldig.
data.domains[].domain string
Velgbart domenenavn.
data.domains[].type string
Lesbar domenenivÄetikett.
data.domains[].custom boolean
Om dette er et egendefinert domene.
POST https://v1.tempmailg.com/api/emails
#

Opprett midlertidig postkasse

Opprett en eid midlertidig postboks. Utelat brukernavn og domene for tilfeldig generering, eller oppgi et tillatt tilpasset brukernavn og et tillatt domene. Provider-parameteren kan velge Gmail- eller Outlook-aliasgenerering.

Parametere 8
Parameter Sted Type Status Beskrivelse
username body string valgfri
Valgfritt tilpasset brukernavn: 2 til 64 ASCII-bokstaver, tall, punktum, understrek eller bindestreker. Krever planrettighet; custom_username aksepteres ogsÄ.
Standard: Tilfeldig generert
domain body string valgfri
En av de tillatte domenene som returneres av GET /domains. Utelatelse velger et tilfeldig tillatt domene.
Standard: Tilfeldig tillatt domene
lifetime body string valgfri
tillatte verdier:
10m — 10 minutter 1h — 1 Time 2h — 2 timer 1d — 1 dag 1w — 1 Uke 1m — 30 dager 3m — 90 dager 6m — 180 dager 1y — 365 dager unlimited — Ubegrenset
Standard: Planens standard levetid
provider body string valgfri
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
Standard: standard
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
pin_confirmation body string valgfri
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
Idempotency-Key header string valgfri
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
Valgfrie body-parametere: username (tilpasset brukernavn hvis tillatt av planen), domain (tillatt domene, f.eks. example.com), lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.
Opprett postboks
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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:07+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:07+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
data.id integer
Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks.
data.pin_protected boolean
Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Generert full postboksadresse.
data.domain string
Domene for den genererte postboksen.
data.provider string
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks.
data.expires_in_seconds number|null
Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null.
data.mailbox_state string
Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv.
data.receiving_enabled boolean
Om denne postkassen for Ăžyeblikket godtar innkommende meldinger.
data.message_count integer
Kjent total meldingstell; den kan gjenspeile den siste postboks‑synkroniseringen.
data.unread_message_count integer
Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen.
data.last_message_received_at string|null
Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig.
data.message_count_synced_at string|null
Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering.
data.created_at string|null
Postboksens opprettelsestid i ISO-8601-format.
data.email_token string
Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den.
data.pin_grant.mailbox_id integer
Postkasse-ID som den betingede lesetillatelsen er knyttet til.
data.pin_grant.unlock_token string
Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting.
data.pin_grant.scope string
Omfanget lest for den betingede opprettelsesbevilgningen.
data.pin_grant.idle_timeout_seconds integer
Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder.
data.pin_grant.expires_at string
Gjeldende utlĂžp for lesetillatelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Oppdater / Bytt postkasse

Opprett eller velg en postboks pÄ det nye brukernavnet og domenet etter Ä ha bekreftet eierskap til den nÄvÊrende postboksen. Dette gir ikke nytt navn til den gamle postboksen eller endrer dens levetid pÄ stedet. NÄr destinasjonen er forskjellig, forblir den gamle postboksen i historikken og kan bli satt pÄ pause av aktive postboksbegrensninger. Gjenbruk av din egen aktive destinasjon pÄfÞrer dens forespurte levetid eller standardplan.

Parametere 9
Parameter Sted Type Status Beskrivelse
email path string pÄkrevd
Gjeldende fullstendige e-postadresse til den eide postkassen som skal byttes. URL-encode hver sti-segment; kod et pluss-tegn som %2B.
username path string pÄkrevd
Nytt Ăžnsket brukernavn: 2 til 64 alfanumeriske tegn; underlagt tillatelse for egendefinert brukernavn.
domain path string pÄkrevd
Nytt tillatt domenenavn.
lifetime body string valgfri
tillatte verdier:
10m — 10 minutter 1h — 1 Time 2h — 2 timer 1d — 1 dag 1w — 1 Uke 1m — 30 dager 3m — 90 dager 6m — 180 dager 1y — 365 dager unlimited — Ubegrenset
Standard: Planens standard levetid
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
pin_confirmation body string valgfri
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
Idempotency-Key header string valgfri
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Bruk en eksisterende eid postkasse-e-post i {email}. Valgfri body-parameter: lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.
Oppdater eid postkasse
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'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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:07+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:07+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
data.id integer
Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks.
data.pin_protected boolean
Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Generert full postboksadresse.
data.domain string
Domene for den genererte postboksen.
data.provider string
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks.
data.expires_in_seconds number|null
Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null.
data.mailbox_state string
Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv.
data.receiving_enabled boolean
Om denne postkassen for Ăžyeblikket godtar innkommende meldinger.
data.message_count integer
Kjent total meldingstell; den kan gjenspeile den siste postboks‑synkroniseringen.
data.unread_message_count integer
Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen.
data.last_message_received_at string|null
Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig.
data.message_count_synced_at string|null
Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering.
data.created_at string|null
Postboksens opprettelsestid i ISO-8601-format.
data.email_token string
Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den.
data.pin_grant.mailbox_id integer
Postkasse-ID som den betingede lesetillatelsen er knyttet til.
data.pin_grant.unlock_token string
Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting.
data.pin_grant.scope string
Omfanget lest for den betingede opprettelsesbevilgningen.
data.pin_grant.idle_timeout_seconds integer
Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder.
data.pin_grant.expires_at string
Gjeldende utlĂžp for lesetillatelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Slett postboks

Slett en eiet postboks og start opprydding av meldinger og filer. Bevarte postboksposter kan bli mykt slettet internt; adressen er ikke lenger brukbar via API-et.

Parametere 3
Parameter Sted Type Status Beskrivelse
email path string pÄkrevd
Full e‑postadresse til den eide postboksen som skal slettes. URL‑kod adressen; kod et pluss‑tegn som %2B.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postbokser: bruk den engangs‑delete‑unlock_token. Fþrst POST pin, scope=delete og action/target_id som returneres av 423‑responsen til PIN‑unlock‑URLen. Et lesetoken kan ikke slette. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string valgfri
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
Slett eid postkasse
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/emails/demo123@example.com' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
message string
Resultat av slettingen. En manglende ressurs returnerer HTTP 404.

Gmail og Outlook-aliaser

Generer e-postbokser med hĂžy omdĂžmme for Gmail- og Outlook/Hotmail-aliaser.

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

Opprett Gmail‑alias

Opprett en ny Gmail-alias midlertidig postboks som eies av den autentiserte brukeren.

Parametere 8
Parameter Sted Type Status Beskrivelse
mode body string valgfri
Generasjonsmodus: auto, dot, plus eller plus_dot. Godtar ogsÄ gmail_alias_mode. Hvis stilvalg ikke er tillatt, brukes auto.
Standard: auto
username body string valgfri
Valgfritt egendefinert alias-suffiks: 2 til 32 ASCII-bokstaver eller sifre, normalisert til smÄ bokstaver; underlagt funksjonstillatelse. Godtar ogsÄ custom_username eller alias_username.
Standard: Automatisk generert
domain body string valgfri
Bruk tilfeldig, gmail.com eller googlemail.com; alias_domain aksepteres ogsĂ„. Ommisjon eller utilgjengelig domene‑valg tillatelse bruker tilfeldig.
Standard: random
lifetime body string valgfri
tillatte verdier:
10m — 10 minutter 1h — 1 Time 2h — 2 timer 1d — 1 dag 1w — 1 Uke 1m — 30 dager 3m — 90 dager 6m — 180 dager 1y — 365 dager unlimited — Ubegrenset
Standard: Planens standard levetid
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
pin_confirmation body string valgfri
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
Idempotency-Key header string valgfri
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
Krever at Gmail Alias API-tillatelsen er aktivert pÄ ditt abonnement eller lÄst opp via en API-kredittpakke. Valgfrie parametere: mode (auto, dot, plus, plus_dot), username (tilpasset alias brukernavn), domain (f.eks. gmail.com, googlemail.com), lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.
Opprett Gmail-aliaspostboks
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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:07+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:07+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
data.id integer
Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks.
data.pin_protected boolean
Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Generert full postboksadresse.
data.domain string
Domene for den genererte postboksen.
data.provider string
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks.
data.expires_in_seconds number|null
Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null.
data.mailbox_state string
Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv.
data.receiving_enabled boolean
Om denne postkassen for Ăžyeblikket godtar innkommende meldinger.
data.message_count integer
Kjent total meldingstell; den kan gjenspeile den siste postboks‑synkroniseringen.
data.unread_message_count integer
Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen.
data.last_message_received_at string|null
Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig.
data.message_count_synced_at string|null
Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering.
data.created_at string|null
Postboksens opprettelsestid i ISO-8601-format.
data.email_token string
Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den.
data.pin_grant.mailbox_id integer
Postkasse-ID som den betingede lesetillatelsen er knyttet til.
data.pin_grant.unlock_token string
Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting.
data.pin_grant.scope string
Omfanget lest for den betingede opprettelsesbevilgningen.
data.pin_grant.idle_timeout_seconds integer
Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder.
data.pin_grant.expires_at string
Gjeldende utlĂžp for lesetillatelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook Alias-domener

Hent aktive Outlook / Hotmail alias-domener som er tilgjengelige for opprettelse av postboks.

Krever at Outlook Alias API-tillatelsen er aktivert pÄ ditt abonnement eller lÄst opp via en API-kredittpakke. Angir om spesifikt domenevalg er lÄst opp i planen din.
Hent Outlook-aliasdomener
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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
            }
        ]
    }
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
data.domains array
Aktive Outlook/Hotmail-domener; et tomt array er gyldig.
data.domains[].domain string
Tilgjengelig domenenavn.
data.domains[].type string
Lesbar leverandĂžretikett.
data.domains[].selectable boolean
Om kontoen din kan velge dette domenet eksplisitt.
data.domains[].locked boolean
Om eksplisitt domenevalg er lÄst for kontoen din.
data.domains[].disabled_reason string|null
Årsak til at domenvalg er lĂ„st, eller null nĂ„r det er valgbart.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Opprett Outlook-alias

Opprett en ny Outlook / Hotmail-alias midlertidig postboks som eies av den autentiserte brukeren.

Parametere 7
Parameter Sted Type Status Beskrivelse
domain body string valgfri
Bruk tilfeldig eller et domene fra GET /outlook-alias/domains; outlook_alias_domain aksepteres ogsÄ. Uten valgrettighet brukes tilfeldig.
Standard: Tilfeldig tilgjengelig domene
username body string valgfri
Valgfritt egendefinert alias-suffiks: 2 til 32 ASCII-bokstaver eller sifre, normalisert til smÄ bokstaver; underlagt funksjonstillatelse. Godtar ogsÄ custom_username eller alias_username.
Standard: Automatisk generert
lifetime body string valgfri
tillatte verdier:
10m — 10 minutter 1h — 1 Time 2h — 2 timer 1d — 1 dag 1w — 1 Uke 1m — 30 dager 3m — 90 dager 6m — 180 dager 1y — 365 dager unlimited — Ubegrenset
Standard: Planens standard levetid
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
pin_confirmation body string valgfri
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
Idempotency-Key header string valgfri
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
Krever at Outlook Alias API-tillatelsen er aktivert pÄ ditt abonnement eller lÄst opp via en API-kredittpakke. Valgfrie parametere: domain (f.eks. outlook.com, hotmail.com), username (tilpasset alias brukernavn), lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.
Opprett Outlook-aliaspostboks
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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:07+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:07+00:00",
        "email_token": "encrypted-email-token"
    }
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
data.id integer
Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks.
data.pin_protected boolean
Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Generert full postboksadresse.
data.domain string
Domene for den genererte postboksen.
data.provider string
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks.
data.expires_in_seconds number|null
Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null.
data.mailbox_state string
Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv.
data.receiving_enabled boolean
Om denne postkassen for Ăžyeblikket godtar innkommende meldinger.
data.message_count integer
Kjent total meldingstell; den kan gjenspeile den siste postboks‑synkroniseringen.
data.unread_message_count integer
Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen.
data.last_message_received_at string|null
Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig.
data.message_count_synced_at string|null
Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering.
data.created_at string|null
Postboksens opprettelsestid i ISO-8601-format.
data.email_token string
Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den.
data.pin_grant.mailbox_id integer
Postkasse-ID som den betingede lesetillatelsen er knyttet til.
data.pin_grant.unlock_token string
Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting.
data.pin_grant.scope string
Omfanget lest for den betingede opprettelsesbevilgningen.
data.pin_grant.idle_timeout_seconds integer
Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder.
data.pin_grant.expires_at string
Gjeldende utlĂžp for lesetillatelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere.

Meldinger og vedlegg

Hent innkommende innbokser, les fullstendige HTML-/tekstmeldinger, og strĂžm vedlegg.

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

List postboksmeldinger

Hent tilgjengelige meldingsoppsummeringer og postboksmetadata. Standard innboks‑skanninger returnerer en nylig batch pĂ„ opptil 25 meldinger; dette er ikke et paginert fullhistorie‑endepunkt. Bruk GET /messages/{messageId} for fullstendige meldingskropper og vedlegg.

Parametere 2
Parameter Sted Type Status Beskrivelse
email query string pÄkrevd
Full e-postadresse til den eide postboksen som skal lese meldinger fra. URL-kodér spÞrringsverdien; kod et plustegn som %2B.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
E-posten mÄ tilhÞre kontoen din. Standard- og Gmail-oppsummeringer inneholder OTP og verification-link felter; Outlook inkluderer ogsÄ from_name, snippet, received_at og has_attachments. LeverandÞrsynkronisering og caching kan forsinke nye meldinger og teller.
Les postkassemeldinger
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'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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:07",
            "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:07+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:07+00:00",
    "message_count_synced_at": "2026-11-19T02:18:07+00:00"
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
mailbox string
Postboksadresse hvis meldinger ble forespurt.
email_token string
Ugjennomsiktig kryptert postboksreferanse; normal autentisering kreves fortsatt.
mailbox_provider string
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
messages array
Meldingsoppsummeringer. En tom innboks returnerer en tom array; hent en enkelt melding for dens innhold og vedlegg.
expire_at string|null
Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks.
expires_in_seconds number|null
Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null.
mailbox_state string
Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv.
receiving_enabled boolean
Om denne postkassen for Ăžyeblikket godtar innkommende meldinger.
message_count integer
Kjent total meldingstell; den kan gjenspeile den siste postboks‑synkroniseringen.
unread_message_count integer
Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen.
last_message_received_at string|null
Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig.
message_count_synced_at string|null
Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering.
mailbox_limit.limit integer
Aktiv postboksgrense for denne leverandĂžren; -1 betyr ubegrenset.
mailbox_limit.limit_label string
Visningsetikett for postbokslimiten.
mailbox_limit.active_count integer
Antall aktive postbokser for denne leverandĂžren.
mailbox_limit.paused_count integer
Antall pausede postbokser for denne leverandĂžren.
mailbox_limit.paused_mailboxes array<string>
Adresser satt pÄ pause av postbokslimitet.
mailbox_limit.remaining integer
GjenvĂŠrende aktive postkasseplasser; -1 betyr ubegrenset. Dette er ikke API-forespĂžrselskvote.
mailbox_limit.remaining_label string
Vis etikett for gjenvĂŠrende postkasseplasser.
mailbox_limit.reached boolean
Om den aktive postboksgrensen er nÄdd.
mailbox_limit.blocked boolean
Om den aktive postboksgrensen er null.
mailbox_limit.provider string|null
LeverandĂžr som postboksgrensen gjelder for.
messages[].id string
Ugjennomsiktig meldings-ID brukt av enkeltmeldings‑, slettings‑ og vedlegg‑endepunktene.
messages[].is_seen boolean
Om meldingen er merket som lest.
messages[].subject string
Meldingsemne.
messages[].from string
Avsenders visningsnavn eller adresse.
messages[].from_email string
Avsender e‑postadresse.
messages[].receivedAt string
Mottatt tid i applikasjonens tidssone, formatert som YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Oppdaget engangskode nÄr tilgjengelig og tillatt; ellers null.
messages[].otp_locked boolean
Om en oppdaget engangskode er skjult av funksjonstillatelser.
messages[].verification_link string|null
Oppdaget verifiserings-URL nÄr tilgjengelig og tillatt; ellers null.
messages[].verification_link_locked boolean
Om en oppdaget verifiseringslenke er skjult av funksjonstillatelser.
messages[].from_name string|null
Outlook‑sammendragfelt: opprinnelig avsendernavn. Mangler i Standard‑ og Gmail‑sammendrag.
messages[].snippet string|null
Outlook-sammendragfelt: kort meldingsforhÄndsvisning.
messages[].received_at string|null
Outlook-sammendragfelt: ISO-8601 mottatt tid, nÄr kjent.
messages[].has_attachments boolean
Outlook‑sammendragfelt: om vedleggsmetadata finnes. Nedlastings‑tilgjengelighet sjekkes separat.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Hent enkeltmelding

Hent en eiet melding ved dens ugjennomsiktige meldings-ID. Returnerer kroppsformater og vedleggsmetadata. Kropps feltene avhenger av meldingsformatet; Outlook legger til leverandĂžrspesifikke felter som er oppfĂžrt nedenfor.

Parametere 2
Parameter Sted Type Status Beskrivelse
messageId path string pÄkrevd
Unik meldings-ID returnert i meldingslisten.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Les en melding
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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:07",
        "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"
            }
        ]
    }
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
data.id string
Ugjennomsiktig meldings-ID.
data.is_seen boolean
Meldingslesestatus. Å lese kan merke den som sett; bufrede data kan gjenspeile en tidligere tilstand.
data.subject string
Meldingsemne.
data.from string
Avsenders visningsnavn eller adresse.
data.from_email string
Avsender e‑postadresse.
data.to string
Mottakers e-postadresse.
data.mailbox_provider string
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
data.receivedAt string
Mottatt tid i applikasjonens tidssone, formatert som YYYY-MM-DD HH:mm:ss.
data.html boolean
Om meldingen har en HTML-body.
data.html_content string
HTML-body nÄr den er tilstede. Standardmeldinger uten HTML kan utelate dette feltet. Behandle meldingsinnhold som upÄlitelig.
data.text_content string
Tekstkropp nÄr tilstede; Standardmeldinger kan inneholde escapet tekst i et pre-element eller utelate dette feltet.
data.content string
Foretrukket innhold for visning, vanligvis HTML nÄr tilgjengelig.
data.attachments array
Vedleggsmetadata, eller en tom matrise. Nedlastinger krever normal autentisering og gjeldende PIN-autorisering.
data.attachments[].name string
Filnavn som skal URL‑kodes som ett enkelt sti‑segment ved nedlasting.
data.attachments[].size integer
VedleggsstĂžrrelse i byte.
data.attachments[].url string
Autentisert bruker-API-nedlastings-URL lagt til vedlegg med et filnavn. En URL garanterer ikke at den lokale filen er tilgjengelig.
data.attachments[].extension string
Standard/Gmail-metadatafelt: filtype nÄr den er oppgitt.
data.attachments[].id string
Outlook-metadatafelt: leverandĂžrvedlegg-ID.
data.attachments[].content_type string
Outlook-metadatafelt: MIME innholdstype.
data.from_name string|null
Outlook-detaljfelt: opprinnelig avsendernavn.
data.to_email string|null
Outlook-detaljfelt: original mottakeradresse.
data.received_at string|null
Outlook-detaljfelt: ISO-8601 mottatt tid.
data.has_html boolean
Outlook-detaljfelt: om en HTML-body finnes.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Slett melding

Slett en enkelt eid melding.

Parametere 3
Parameter Sted Type Status Beskrivelse
messageId path string pÄkrevd
Unik meldings-ID-streng for permanent sletting.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postbokser: bruk den engangs‑delete‑unlock_token. Fþrst POST pin, scope=delete og action/target_id som returneres av 423‑responsen til PIN‑unlock‑URLen. Et lesetoken kan ikke slette. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string valgfri
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
Slett ett meldingspunkt
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Responsfelter
Felt Type Beskrivelse
status boolean
Om operasjonen lyktes.
message string
Resultat av slettingen. En manglende ressurs returnerer HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Last ned vedlegg

Last ned en vedlegg fra en eid melding.

Parametere 3
Parameter Sted Type Status Beskrivelse
messageId path string pÄkrevd
ID for meldingen som inneholder filen.
filename path string pÄkrevd
Filnavn og filtype pÄ vedlegget som skal lastes ned.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Suksess returnerer filbytes, ikke JSON. For store filer returnerer HTTP 403; manglende eller utilgjengelige lokale filer returnerer HTTP 404. URL-enkod filnavnet som ett enkelt sti-segment. Vedleggsmetadata alene garanterer ikke at nedlasting er tilgjengelig.
Last ned en vedlegg
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
Nedlastingsatferd Dette endepunktet returnerer den forespurte filen direkte i stedet for en JSON-tekst.
Responsfelter
Felt Type Beskrivelse
Content-Disposition header
Vellykket respons laster ned det forespurte filnavnet.
body binary
Filbytes ved suksess, ikke JSON. Feil returnerer JSON med en ikke-2xx status.

Ratebegrensninger og kvoter

OvervÄk sanntidsforespÞrselsbudsjetter, hastighetsbegrensninger og kontokvoter uten Ä bruke kreditter.

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

Ratebegrensning og kvote

Sjekk din nÄvÊrende hastighetsgrense og kvotestatus uten Ä bruke noen API-bruk. Dette endepunktet er kvotefritt og trekker ikke fra mÄnedlige API-kreditter (misbrukbeskyttelsesgrense: 60 forespÞrsler/min).

X-RateLimit-* beskriver det angitte forespĂžrselsbudsjettet; X-Quota-* beskriver mĂ„nedlig og kjĂžpt kapasitet nĂ„r tilgjengelig. X-Mailbox-RateLimit-* rapporterer det separate postboksopprettings-/oppdateringsbudsjettet. En avvisning kun for postboks bruker postboksskop og sitt eget gjenforsĂžkvindu. Avvisninger med minuttgrense kan utelate kvoteinformasjon. Retry-After inkluderes kun for et tidsbestemt gjenforsĂžk; deaktivert tilgang kan kreve en kontendring. I dette vellykkede statussvaret beskriver data.limit, data.remaining og data.reset kontots minuttsbudsjett, ikke brukbare kreditter. data.quota-objektet beskriver mĂ„nedlig tillatelse, kredittsaldier og bruk. De eksisterende feltene data.monthly_limit, data.monthly_remaining og data.purchased_credits forblir aliaser til de tilsvarende kvote-feltene. En vellykket statuskontroll gir ikke autorisasjon til en annen API‑operasjon. Operasjoner krever fortsatt aktivert tilgang, tilgjengelig kvote og godkjenning gjennom alle gjeldende grenser. Kvote‑snapshotet lover ikke kapasitet som allerede er reservert av en pĂ„gĂ„ende forespĂžrsel.
Sjekk status for ratebegrensning
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.

Eksempel pÄ svar
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"
        }
    }
}
Responsfelter
Felt Type Beskrivelse
data.limit integer|string
Kontoens forespÞrsler-per-minutt-grense. Strengen unlimited betegner et ubegrenset minuttbudsjett; dette er uavhengig av mÄnedlig kvote.
data.remaining integer|string
GjenvĂŠrende konto‑minuttbudsjettplasser, eller strengen unlimited. En positiv verdi betyr ikke at API‑kreditter gjenstĂ„r.
data.reset integer
Sekunder for kontots minuttvindu, ikke den mÄnedlige kvote-tilbakestillingen. Deaktiverte eller ubegrensede minuttbudsjetter kan beholde en nominell verdi pÄ 60 sekunder; dette garanterer ikke tilgang etter venting.
data.plan string
NÄvÊrende planetikett. Det lesbare planenavnet er gitt separat i data.quota.plan_name.
data.quota.enabled boolean
Om global og plan/kreditt API-tilgang er aktivert. Dette indikerer ikke gjenvĂŠrende kapasitet eller erstatter bruker-API-bryteren.
data.quota.user_api_status boolean
Om brukeren har aktivert sin User API-bryter. Operasjoner krever denne bryteren samt aktivert tilgang og tilgjengelig kapasitet.
data.quota.plan_name string
Lesbart navn pÄ gjeldende plan.
data.quota.period string
KalendermÄnedens bruksperiode i formatet YYYY-MM, med applikasjonens tidssone; ikke nÞdvendigvis abonnementets faktureringsperiode.
data.quota.base_limit integer
Basis mÄnedlig plan tillatelse. En verdi pÄ -1 betyr ubegrenset.
data.quota.extra_requests integer
Ekstra mÄnedlig tillatelse gitt for den nÄvÊrende bruksperioden; separat fra kjÞpte kreditter.
data.quota.monthly_limit integer
Grunnleggende kvote pluss ekstra forespÞrsler for innevÊrende periode. En verdi pÄ -1 betyr ubegrenset. KjÞpte kreditter er ikke inkludert.
data.quota.monthly_remaining integer|null
GjenvÊrende endelige mÄnedlige kvote, eller null nÄr den mÄnedlige kvoten er ubegrenset. Null mÄ ikke tolkes som null.
data.quota.used integer
Vellykkede, tellede API‑operasjoner i den nĂ„vĂŠrende bruksperioden, inkludert operasjoner som bruker kreditter. Statuskontroller Ăžker ikke denne verdien.
data.quota.purchased_credits integer
Gjeldende kredittsaldo, inkludert bonuskreditter for aktiv plan. Bonuskreditter mÄ ikke legges til denne saldoen en gang til.
data.quota.bonus_credits integer
Aktiv planbonusdel av kredittbalansen; en oppdeling av purchased_credits, ikke ekstra kapasitet.
data.quota.direct_purchased_credits integer
Kredittsaldo ekskludert den aktive plan-bonusdelen. Denne verdien pluss bonus_credits er lik purchased_credits.
data.quota.remaining integer|null
MÄnedlig gjenvÊrende kvote pluss nÄvÊrende kredittsaldo, uten Ä telle bonuser dobbelt. Null betyr ubegrenset mÄnedlig kvote. Individuelle funksjonstillatelser og andre forespÞrselsgrenser gjelder fortsatt.
data.quota.unlimited boolean
Om mÄnedlig kvote er ubegrenset. Dette gjÞr ikke kontoens minuttsbudsjett eller andre funksjonsgrenser ubegrenset.
data.quota.usage_percent integer
Dashboard-kompatibel avrundet prosent fra 0 til 100: brukt delt pÄ brukt pluss resterende, multiplisert med 100. Den inkluderer tilgjengelig kredittkapasitet, sÄ pÄfylling kan senke prosentandelen. Den er 0 for ubegrenset kvote eller et nullstÞrrelses-pool; den er ikke prosentandelen for minuttraten eller en tilgangsbeslutning.
data.quota.reset_at string
ISO-8601-tidsstempel med tidssoneforskyvning for neste kalendermÄnedens kvote-tilbakestilling. Dette er ikke abonnementets utlÞpsdato, og den mÄnedlige tilbakestillingen fyller ikke pÄ kjÞpte kreditter.
status string
Den bokstavelige suksessen for dette status-endepunktet. Andre vellykkede postboks-endepunkter bruker den boolske true.
data.monthly_limit integer
Kompatibilitetsalias for det tilsvarende data.quota-feltet; ikke legg det til igjen nÄr du beregner saldoer.
data.monthly_remaining integer|null
Kompatibilitetsalias for det tilsvarende data.quota-feltet; ikke legg det til igjen nÄr du beregner saldoer.
data.purchased_credits integer
Kompatibilitetsalias for det tilsvarende data.quota-feltet; ikke legg det til igjen nÄr du beregner saldoer.

Postboks PIN-beskyttelse

Skriv inn PIN-koden for Ä fortsette. Postkassen din forblir ulÄst sÄ lenge den er aktiv i denne nettsesjonen.

Godtar du informasjonskapsler?

Vi bruker informasjonskapsler for Ä forbedre din nettleseropplevelse. Ved Ä bruke dette nettstedet samtykker du til vÄr informasjonskapselpolicy.

Mer