TempMail API-dokumentation

REST API v1 & Webhooks

TempMailg Udvikler API-dokumentation

Brug denne dokumentation til at generere din personlige API-nøgle, tilslut den dedikerede bruger-API-vært, læs postkassebeskeder, administrer ejede postkasser og integrer Temp Mail i dine egne apps eller automatiseringer.

Bearer Token-godkendelse Webhooks i realtid Gmail & Outlook-aliaser JSON-svar
Bruger API-basen-URL HTTPS
Anmodningsformat Brug kun din API-nøgle i Autorisations Bearer-header og hold endpoint-URL'er rene.

Postkasseadministration

Hent tilladte domæner, opret eller skift postkasser, vælg tilladte levetider, og slet ejede adresser.

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

Liste over tilladte domæner

List tilgængelige domæner til oprettelse af midlertidige e‑mails. Filtrer efter type for kun at se gratis, premium eller brugerdefinerede domæner, som understøttes af dit abonnement.

Parametre 1
Parameter Placering Type Status Beskrivelse
type query string valgfri
Domæneniveau-filter. Udeladelse bruger alle, når premium-domæneadgang er aktiveret, ellers gratis. Genkendte værdier: free, basic, pro, premium, custom, ultimate, all
Standard: Kontoafhængig
Få tilladte domæner
curl --request GET \
  --url 'https://v1.tempmailg.com/api/domains?type=free' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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
            }
        ]
    }
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
data.requested_type string
Anvendt domænefilter.
data.plan string
Aktuel planmærke.
data.plan_name string
Læseligt navn på den aktuelle plan.
data.allowed_types array<string>
Domænefiltre tilgængelige for denne konto. Et genkendt filter kan stadig være forbudt for din plan.
data.domains array
Valgbare domæner efter filtrering; et tomt array er gyldigt.
data.domains[].domain string
Valgbar domænenavn.
data.domains[].type string
Læsbar domænetieretiket.
data.domains[].custom boolean
Om dette er et brugerdefineret domæne.
POST https://v1.tempmailg.com/api/emails
#

Opret midlertidig postkasse

Opret en ejet midlertidig postkasse. Udelad brugernavn og domæne for tilfældig generering, eller angiv et tilladt brugerdefineret brugernavn og et tilladt domæne. Provider-parameteren kan vælge Gmail- eller Outlook-aliasgenerering.

Parametre 8
Parameter Placering Type Status Beskrivelse
username body string valgfri
Valgfrit brugerdefineret brugernavn: 2 til 64 ASCII‑bogstaver, tal, punktummer, understregninger eller bindestreger. Kræver plan‑tilladelse; custom_username accepteres også.
Standard: Tilfældigt genereret
domain body string valgfri
Et af de tilladte domæner returneret af GET /domains. Udeladelse vælger et tilfældigt tilladt domæne.
Standard: Tilfældig tilladt domæne
lifetime body string valgfri
tilladte værdier:
10m — 10 Minutter 1h — 1 Time 2h — 2 Timer 1d — 1 dag 1w — 1 Uge 1m — 30 Dage 3m — 90 dage 6m — 180 Dage 1y — 365 Dage unlimited — Ubegrænset
Standard: Planens standardlevetid
provider body string valgfri
Postkasseudbyder: standard, gmail_alias eller outlook_alias.
Standard: standard
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkasse, når det er tilladt af din plan. Det ændrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
Krævet når pin_enabled er true: en PIN på 6 til 8 cifre, sendt som en string for at bevare foranstillede nuller.
pin_confirmation body string valgfri
Påkrævet når pin_enabled er true. Skal matche pin nøjagtigt.
Idempotency-Key header string valgfri
Påkrævet for PIN-beskyttet oprettelse eller sletning: en stabil nøgle på 16 til 128 tegn. Gentag den identiske anmodning med den samme nøgle for at undgå dobbelt arbejde.
Valgfrie body-parametre: username (tilpasset brugernavn hvis tilladt af planen), domain (tilladt domæne, f.eks. example.com), lifetime (tilladte værdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Udelad levetid, eller lad den stå tom, for at bruge standard e-maillevetid konfigureret for din nuværende månedlige/årlige plan. Send en tilladt levetid, f.eks. 1t, for at tilsidesætte standarden. Ubegrænset bruges kun, når det er konfigureret som planens standard eller udtrykkeligt anmodet om og tilladt. Kropparametrene mailbox_lifetime og email_lifetime accepteres også; den første ikke-tomme værdi vinder i denne rækkefølge: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tilladte værdier returnerer HTTP 422 i stedet for stille at vælge en standard.
Opret postkasse
curl --request POST \
  --url 'https://v1.tempmailg.com/api/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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:17:49+00:00",
        "expires_in_seconds": 86399.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:49+00:00",
        "email_token": "encrypted-email-token"
    }
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
data.id integer
Mailbox‑ID. Genererede ID'er, adresser og tokens varierer for hver mailbox.
data.pin_protected boolean
Om denne postkasse har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Genereret fuld postkasseadresse.
data.domain string
Domæne for den genererede postkasse.
data.provider string
Postkasseudbyder: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Gældende udløb som en ISO-8601 tidsstempel, eller null for en ubegrænset postkasse.
data.expires_in_seconds number|null
Ikke-negative sekunder tilbage ved beregning; brøkdele af sekunder er mulige. Null betyder ubegrænset, ikke nul.
data.mailbox_state string
Aktuel postkassetilstand: aktiv, pauset, udløbet eller inaktiv.
data.receiving_enabled boolean
Om denne postkasse i øjeblikket accepterer indgående beskeder.
data.message_count integer
Kendt samlet beskedantal; den kan afspejle den sidste postkasse‑synkronisering.
data.unread_message_count integer
Kendt antal ulæste beskeder; den kan afspejle den sidste postkasse-synkronisering.
data.last_message_received_at string|null
Sidste kendte modtagne-besked tidspunkt i ISO-8601 format, eller null når utilgængelig.
data.message_count_synced_at string|null
Sidste synkroniseringstid for meddelelsestælling i ISO-8601-format, eller null før synkronisering.
data.created_at string|null
Mailbox-oprettelsestid i ISO-8601-format.
data.email_token string
Uigennemsigtig krypteret postkasse-reference. Den erstatter ikke Bearer-godkendelse, ejerskabstjek eller PIN-godkendelse.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postkasseoprettelse returnerer denne læsetilladelse; almindelig ubeskyttet oprettelse udelader den.
data.pin_grant.mailbox_id integer
Mailbox-ID, som den betingede læsetilladelse er knyttet til.
data.pin_grant.unlock_token string
Uigennemsigtig læsetoken for X-Mailbox-Unlock med de samme ejerlegitimationsoplysninger. Hold den privat og i hukommelsen; en læsetilladelse autoriserer ikke sletning.
data.pin_grant.scope string
Omfanget læses for den betingede oprettelsesbevilling.
data.pin_grant.idle_timeout_seconds integer
Tilladt inaktiv tid for læsetilladelsen, normalt 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for læsetilladelsen, normalt 86400 sekunder.
data.pin_grant.expires_at string
Nuværende udløb af læsetilladelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolut udløb af læse-tilladelse i ISO-8601-format. Sikkerhedsændringer kan tilbagekalde tilladelsen tidligere.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

Opdater / Skift postkasse

Opret eller vælg en postkasse på det nye brugernavn og domæne efter at have bekræftet ejerskabet af den aktuelle postkasse. Dette omdøber ikke den gamle postkasse eller ændrer dens levetid på stedet. Når destinationen er anderledes, forbliver den gamle postkasse i historikken og kan blive sat på pause af aktive postkassegrænser. Genbrug af din egen aktive destination anvender igen dens ønskede levetid eller standardplan.

Parametre 9
Parameter Placering Type Status Beskrivelse
email path string påkrævet
Nuværende fulde e‑mailadresse for den ejede mailbox, der skal skiftes. URL-encode hver sti‑segment; kod et plus‑tegn som %2B.
username path string påkrævet
Nyt ønsket brugernavn: 2 til 64 alfanumeriske tegn; underlagt tilladelse til brugerdefineret brugernavn.
domain path string påkrævet
Nyt tilladt domænenavn.
lifetime body string valgfri
tilladte værdier:
10m — 10 Minutter 1h — 1 Time 2h — 2 Timer 1d — 1 dag 1w — 1 Uge 1m — 30 Dage 3m — 90 dage 6m — 180 Dage 1y — 365 Dage unlimited — Ubegrænset
Standard: Planens standardlevetid
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkasse, når det er tilladt af din plan. Det ændrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
Krævet når pin_enabled er true: en PIN på 6 til 8 cifre, sendt som en string for at bevare foranstillede nuller.
pin_confirmation body string valgfri
Påkrævet når pin_enabled er true. Skal matche pin nøjagtigt.
Idempotency-Key header string valgfri
Påkrævet for PIN-beskyttet oprettelse eller sletning: en stabil nøgle på 16 til 128 tegn. Gentag den identiske anmodning med den samme nøgle for at undgå dobbelt arbejde.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postkasser: brug en read unlock_token. Først POST pin og scope=read til PIN-unlock URL'en. Bevar din normale Bearer-godkendelse. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Brug en eksisterende ejet postkasse-email i {email}. Valgfri body-parameter: lifetime (tilladte værdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Udelad levetid, eller lad den stå tom, for at bruge standard e-maillevetid konfigureret for din nuværende månedlige/årlige plan. Send en tilladt levetid, f.eks. 1t, for at tilsidesætte standarden. Ubegrænset bruges kun, når det er konfigureret som planens standard eller udtrykkeligt anmodet om og tilladt. Kropparametrene mailbox_lifetime og email_lifetime accepteres også; den første ikke-tomme værdi vinder i denne rækkefølge: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tilladte værdier returnerer HTTP 422 i stedet for stille at vælge en standard.
Opdater ejet 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'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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:27:49+00:00",
        "expires_in_seconds": 599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:49+00:00",
        "email_token": "encrypted-email-token"
    }
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
data.id integer
Mailbox‑ID. Genererede ID'er, adresser og tokens varierer for hver mailbox.
data.pin_protected boolean
Om denne postkasse har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Genereret fuld postkasseadresse.
data.domain string
Domæne for den genererede postkasse.
data.provider string
Postkasseudbyder: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Gældende udløb som en ISO-8601 tidsstempel, eller null for en ubegrænset postkasse.
data.expires_in_seconds number|null
Ikke-negative sekunder tilbage ved beregning; brøkdele af sekunder er mulige. Null betyder ubegrænset, ikke nul.
data.mailbox_state string
Aktuel postkassetilstand: aktiv, pauset, udløbet eller inaktiv.
data.receiving_enabled boolean
Om denne postkasse i øjeblikket accepterer indgående beskeder.
data.message_count integer
Kendt samlet beskedantal; den kan afspejle den sidste postkasse‑synkronisering.
data.unread_message_count integer
Kendt antal ulæste beskeder; den kan afspejle den sidste postkasse-synkronisering.
data.last_message_received_at string|null
Sidste kendte modtagne-besked tidspunkt i ISO-8601 format, eller null når utilgængelig.
data.message_count_synced_at string|null
Sidste synkroniseringstid for meddelelsestælling i ISO-8601-format, eller null før synkronisering.
data.created_at string|null
Mailbox-oprettelsestid i ISO-8601-format.
data.email_token string
Uigennemsigtig krypteret postkasse-reference. Den erstatter ikke Bearer-godkendelse, ejerskabstjek eller PIN-godkendelse.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postkasseoprettelse returnerer denne læsetilladelse; almindelig ubeskyttet oprettelse udelader den.
data.pin_grant.mailbox_id integer
Mailbox-ID, som den betingede læsetilladelse er knyttet til.
data.pin_grant.unlock_token string
Uigennemsigtig læsetoken for X-Mailbox-Unlock med de samme ejerlegitimationsoplysninger. Hold den privat og i hukommelsen; en læsetilladelse autoriserer ikke sletning.
data.pin_grant.scope string
Omfanget læses for den betingede oprettelsesbevilling.
data.pin_grant.idle_timeout_seconds integer
Tilladt inaktiv tid for læsetilladelsen, normalt 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for læsetilladelsen, normalt 86400 sekunder.
data.pin_grant.expires_at string
Nuværende udløb af læsetilladelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolut udløb af læse-tilladelse i ISO-8601-format. Sikkerhedsændringer kan tilbagekalde tilladelsen tidligere.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

Slet postkasse

Slet en ejet postkasse og udløse dens besked- og filoprydning. Bevarede postkasseposter kan blive blødt slettet internt; adressen er ikke længere brugbar via API'en.

Parametre 3
Parameter Placering Type Status Beskrivelse
email path string påkrævet
Fuld e-mailadresse på den ejede postkasse, der skal slettes. URL-encode adressen; kod et plus-tegn som %2B.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postkasser: brug den engangs‑slet‑unlock_token. Først POST pin, scope=delete og den action/target_id, der returneres af 423‑svaret til PIN‑unlock‑URL’en. Et læse‑token kan ikke slette. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string valgfri
Påkrævet for PIN-beskyttet oprettelse eller sletning: en stabil nøgle på 16 til 128 tegn. Gentag den identiske anmodning med den samme nøgle for at undgå dobbelt arbejde.
Slet ejet 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'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke felter.

Eksempel på svar
200 OK • JSON
{
    "status": true,
    "message": "Email has been successfully deleted."
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
message string
Resultat af sletningen. En manglende ressource returnerer HTTP 404.

Gmail & Outlook-aliaser

Generer høj‑omdømme Gmail- og Outlook/Hotmail-aliasmailbokse.

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

Opret Gmail‑alias

Opret en ny Gmail-alias midlertidig postkasse, som ejes af den godkendte bruger.

Parametre 8
Parameter Placering Type Status Beskrivelse
mode body string valgfri
Generationsmode: auto, dot, plus eller plus_dot. Accepterer også gmail_alias_mode. Hvis stilvalg ikke er tilladt, bruges auto.
Standard: auto
username body string valgfri
Valgfri brugerdefineret alias-suffiks: 2 til 32 ASCII-bogstaver eller tal, normaliseret til små bogstaver; underlagt funktionstilladelse. Accepterer også custom_username eller alias_username.
Standard: Automatisk genereret
domain body string valgfri
Brug tilfældig, gmail.com eller googlemail.com; alias_domain accepteres også. Udeladelse eller utilgængelig domænevalgstilladelse bruger tilfældig.
Standard: random
lifetime body string valgfri
tilladte værdier:
10m — 10 Minutter 1h — 1 Time 2h — 2 Timer 1d — 1 dag 1w — 1 Uge 1m — 30 Dage 3m — 90 dage 6m — 180 Dage 1y — 365 Dage unlimited — Ubegrænset
Standard: Planens standardlevetid
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkasse, når det er tilladt af din plan. Det ændrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
Krævet når pin_enabled er true: en PIN på 6 til 8 cifre, sendt som en string for at bevare foranstillede nuller.
pin_confirmation body string valgfri
Påkrævet når pin_enabled er true. Skal matche pin nøjagtigt.
Idempotency-Key header string valgfri
Påkrævet for PIN-beskyttet oprettelse eller sletning: en stabil nøgle på 16 til 128 tegn. Gentag den identiske anmodning med den samme nøgle for at undgå dobbelt arbejde.
Kræver, at Gmail Alias API-tilladelsen er aktiveret på dit abonnement eller låst op via en API-kreditpakke. Valgfrie parametre: mode (auto, dot, plus, plus_dot), username (tilpasset alias brugernavn), domain (f.eks. gmail.com, googlemail.com), lifetime (tilladte værdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Udelad levetid, eller lad den stå tom, for at bruge standard e-maillevetid konfigureret for din nuværende månedlige/årlige plan. Send en tilladt levetid, f.eks. 1t, for at tilsidesætte standarden. Ubegrænset bruges kun, når det er konfigureret som planens standard eller udtrykkeligt anmodet om og tilladt. Kropparametrene mailbox_lifetime og email_lifetime accepteres også; den første ikke-tomme værdi vinder i denne rækkefølge: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tilladte værdier returnerer HTTP 422 i stedet for stille at vælge en standard.
Opret Gmail-aliaspostkasse
curl --request POST \
  --url 'https://v1.tempmailg.com/api/gmail-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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:17:49+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:49+00:00",
        "email_token": "encrypted-email-token"
    }
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
data.id integer
Mailbox‑ID. Genererede ID'er, adresser og tokens varierer for hver mailbox.
data.pin_protected boolean
Om denne postkasse har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Genereret fuld postkasseadresse.
data.domain string
Domæne for den genererede postkasse.
data.provider string
Postkasseudbyder: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Gældende udløb som en ISO-8601 tidsstempel, eller null for en ubegrænset postkasse.
data.expires_in_seconds number|null
Ikke-negative sekunder tilbage ved beregning; brøkdele af sekunder er mulige. Null betyder ubegrænset, ikke nul.
data.mailbox_state string
Aktuel postkassetilstand: aktiv, pauset, udløbet eller inaktiv.
data.receiving_enabled boolean
Om denne postkasse i øjeblikket accepterer indgående beskeder.
data.message_count integer
Kendt samlet beskedantal; den kan afspejle den sidste postkasse‑synkronisering.
data.unread_message_count integer
Kendt antal ulæste beskeder; den kan afspejle den sidste postkasse-synkronisering.
data.last_message_received_at string|null
Sidste kendte modtagne-besked tidspunkt i ISO-8601 format, eller null når utilgængelig.
data.message_count_synced_at string|null
Sidste synkroniseringstid for meddelelsestælling i ISO-8601-format, eller null før synkronisering.
data.created_at string|null
Mailbox-oprettelsestid i ISO-8601-format.
data.email_token string
Uigennemsigtig krypteret postkasse-reference. Den erstatter ikke Bearer-godkendelse, ejerskabstjek eller PIN-godkendelse.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postkasseoprettelse returnerer denne læsetilladelse; almindelig ubeskyttet oprettelse udelader den.
data.pin_grant.mailbox_id integer
Mailbox-ID, som den betingede læsetilladelse er knyttet til.
data.pin_grant.unlock_token string
Uigennemsigtig læsetoken for X-Mailbox-Unlock med de samme ejerlegitimationsoplysninger. Hold den privat og i hukommelsen; en læsetilladelse autoriserer ikke sletning.
data.pin_grant.scope string
Omfanget læses for den betingede oprettelsesbevilling.
data.pin_grant.idle_timeout_seconds integer
Tilladt inaktiv tid for læsetilladelsen, normalt 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for læsetilladelsen, normalt 86400 sekunder.
data.pin_grant.expires_at string
Nuværende udløb af læsetilladelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolut udløb af læse-tilladelse i ISO-8601-format. Sikkerhedsændringer kan tilbagekalde tilladelsen tidligere.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook-aliasdomæner

Hent aktive Outlook / Hotmail alias-domæner, der er tilgængelige for oprettelse af postkasse.

Kræver, at Outlook Alias API-tilladelsen er aktiveret på dit abonnement eller låst op via en API-kreditpakke. Angiver, om specifikt domænevalg er låst op på din plan.
Hent Outlook-aliasdomæner
curl --request GET \
  --url 'https://v1.tempmailg.com/api/outlook-alias/domains' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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
            }
        ]
    }
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
data.domains array
Aktive Outlook/Hotmail-domæner; et tomt array er gyldigt.
data.domains[].domain string
Tilgængeligt domænenavn.
data.domains[].type string
Læsbar udbyderetiket.
data.domains[].selectable boolean
Om din konto eksplicit kan vælge dette domæne.
data.domains[].locked boolean
Om eksplicit domænevalg er låst for din konto.
data.domains[].disabled_reason string|null
Årsag til at domænevalg er låst, eller null når det er valgbart.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

Opret Outlook-alias

Opret en ny Outlook/Hotmail-alias midlertidig postkasse, som ejes af den godkendte bruger.

Parametre 7
Parameter Placering Type Status Beskrivelse
domain body string valgfri
Brug tilfældig eller et domæne fra GET /outlook-alias/domains; outlook_alias_domain accepteres også. Uden tilladelse til valg bruges tilfældig.
Standard: Tilfældig tilgængelig domæne
username body string valgfri
Valgfri brugerdefineret alias-suffiks: 2 til 32 ASCII-bogstaver eller tal, normaliseret til små bogstaver; underlagt funktionstilladelse. Accepterer også custom_username eller alias_username.
Standard: Automatisk genereret
lifetime body string valgfri
tilladte værdier:
10m — 10 Minutter 1h — 1 Time 2h — 2 Timer 1d — 1 dag 1w — 1 Uge 1m — 30 Dage 3m — 90 dage 6m — 180 Dage 1y — 365 Dage unlimited — Ubegrænset
Standard: Planens standardlevetid
pin_enabled body boolean valgfri
Valgfri PIN-beskyttelse for den nye postkasse, når det er tilladt af din plan. Det ændrer ikke PIN-koden for en eksisterende postkasse.
Standard: false
pin body string valgfri
Krævet når pin_enabled er true: en PIN på 6 til 8 cifre, sendt som en string for at bevare foranstillede nuller.
pin_confirmation body string valgfri
Påkrævet når pin_enabled er true. Skal matche pin nøjagtigt.
Idempotency-Key header string valgfri
Påkrævet for PIN-beskyttet oprettelse eller sletning: en stabil nøgle på 16 til 128 tegn. Gentag den identiske anmodning med den samme nøgle for at undgå dobbelt arbejde.
Kræver, at Outlook Alias API-tilladelsen er aktiveret på dit abonnement eller låst op via en API-kreditpakke. Valgfrie parametre: domain (f.eks. outlook.com, hotmail.com), username (tilpasset alias brugernavn), lifetime (tilladte værdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Udelad levetid, eller lad den stå tom, for at bruge standard e-maillevetid konfigureret for din nuværende månedlige/årlige plan. Send en tilladt levetid, f.eks. 1t, for at tilsidesætte standarden. Ubegrænset bruges kun, når det er konfigureret som planens standard eller udtrykkeligt anmodet om og tilladt. Kropparametrene mailbox_lifetime og email_lifetime accepteres også; den første ikke-tomme værdi vinder i denne rækkefølge: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tilladte værdier returnerer HTTP 422 i stedet for stille at vælge en standard.
Opret Outlook-aliasmailboks
curl --request POST \
  --url 'https://v1.tempmailg.com/api/outlook-alias/emails' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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:17:49+00:00",
        "expires_in_seconds": 3599.75,
        "mailbox_state": "active",
        "receiving_enabled": true,
        "message_count": 0,
        "unread_message_count": 0,
        "last_message_received_at": null,
        "message_count_synced_at": null,
        "created_at": "2026-11-19T02:17:49+00:00",
        "email_token": "encrypted-email-token"
    }
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
data.id integer
Mailbox‑ID. Genererede ID'er, adresser og tokens varierer for hver mailbox.
data.pin_protected boolean
Om denne postkasse har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres.
data.email string
Genereret fuld postkasseadresse.
data.domain string
Domæne for den genererede postkasse.
data.provider string
Postkasseudbyder: standard, gmail_alias eller outlook_alias.
data.expire_at string|null
Gældende udløb som en ISO-8601 tidsstempel, eller null for en ubegrænset postkasse.
data.expires_in_seconds number|null
Ikke-negative sekunder tilbage ved beregning; brøkdele af sekunder er mulige. Null betyder ubegrænset, ikke nul.
data.mailbox_state string
Aktuel postkassetilstand: aktiv, pauset, udløbet eller inaktiv.
data.receiving_enabled boolean
Om denne postkasse i øjeblikket accepterer indgående beskeder.
data.message_count integer
Kendt samlet beskedantal; den kan afspejle den sidste postkasse‑synkronisering.
data.unread_message_count integer
Kendt antal ulæste beskeder; den kan afspejle den sidste postkasse-synkronisering.
data.last_message_received_at string|null
Sidste kendte modtagne-besked tidspunkt i ISO-8601 format, eller null når utilgængelig.
data.message_count_synced_at string|null
Sidste synkroniseringstid for meddelelsestælling i ISO-8601-format, eller null før synkronisering.
data.created_at string|null
Mailbox-oprettelsestid i ISO-8601-format.
data.email_token string
Uigennemsigtig krypteret postkasse-reference. Den erstatter ikke Bearer-godkendelse, ejerskabstjek eller PIN-godkendelse.
data.pin_grant object
Betinget: aktiv PIN-beskyttet postkasseoprettelse returnerer denne læsetilladelse; almindelig ubeskyttet oprettelse udelader den.
data.pin_grant.mailbox_id integer
Mailbox-ID, som den betingede læsetilladelse er knyttet til.
data.pin_grant.unlock_token string
Uigennemsigtig læsetoken for X-Mailbox-Unlock med de samme ejerlegitimationsoplysninger. Hold den privat og i hukommelsen; en læsetilladelse autoriserer ikke sletning.
data.pin_grant.scope string
Omfanget læses for den betingede oprettelsesbevilling.
data.pin_grant.idle_timeout_seconds integer
Tilladt inaktiv tid for læsetilladelsen, normalt 3600 sekunder.
data.pin_grant.absolute_timeout_seconds integer
Maksimal levetid for læsetilladelsen, normalt 86400 sekunder.
data.pin_grant.expires_at string
Nuværende udløb af læsetilladelse i ISO-8601-format.
data.pin_grant.absolute_expires_at string
Absolut udløb af læse-tilladelse i ISO-8601-format. Sikkerhedsændringer kan tilbagekalde tilladelsen tidligere.

Beskeder & vedhæftede filer

Hent indgående indbakker, læs fulde HTML-/tekstbeskeder, og stream vedhæftede filer.

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

Vis postkassebeskeder

Hent tilgængelige beskedsammendrag og postkassemetadata. Standardindbakke-scanninger returnerer et nyligt batch på op til 25 beskeder; dette er ikke et pagineret fuldhistorik-endpoint. Brug GET /messages/{messageId} for fulde indhold og vedhæftninger.

Parametre 2
Parameter Placering Type Status Beskrivelse
email query string påkrævet
Fuld e-mailadresse på den ejede postkasse, som der skal læses beskeder fra. URL-kodér forespørgselsværdien; kod et plus-tegn som %2B.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postkasser: brug en read unlock_token. Først POST pin og scope=read til PIN-unlock URL'en. Bevar din normale Bearer-godkendelse. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
E-mailen skal tilhøre din konto. Standard- og Gmail‑oversigter indeholder OTP- og verification-link‑felter; Outlook inkluderer også from_name, snippet, received_at og has_attachments. Udbydersynkronisering og caching kan forsinke nye beskeder og tællinger.
Læs postkassebeskeder
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'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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:17:49",
            "id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
            "otp": null,
            "otp_locked": false,
            "verification_link": null,
            "verification_link_locked": false
        }
    ],
    "mailbox_provider": "standard",
    "mailbox_state": "active",
    "expire_at": "2026-11-20T02:17:49+00:00",
    "expires_in_seconds": 86399.75,
    "receiving_enabled": true,
    "mailbox_limit": {
        "limit": 50,
        "limit_label": "50",
        "active_count": 1,
        "paused_count": 0,
        "paused_mailboxes": [],
        "remaining": 49,
        "remaining_label": "49",
        "reached": false,
        "blocked": false,
        "provider": "standard"
    },
    "message_count": 1,
    "unread_message_count": 1,
    "last_message_received_at": "2026-11-19T02:17:49+00:00",
    "message_count_synced_at": "2026-11-19T02:17:49+00:00"
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
mailbox string
Postboksadresse, hvis meddelelser blev anmodet om.
email_token string
Uigennemsigtig krypteret postkasse-reference; normal godkendelse er stadig påkrævet.
mailbox_provider string
Postkasseudbyder: standard, gmail_alias eller outlook_alias.
messages array
Beskedopsummeringer. En tom indbakke returnerer et tomt array; hent en enkelt besked for dens indhold og vedhæftede filer.
expire_at string|null
Gældende udløb som en ISO-8601 tidsstempel, eller null for en ubegrænset postkasse.
expires_in_seconds number|null
Ikke-negative sekunder tilbage ved beregning; brøkdele af sekunder er mulige. Null betyder ubegrænset, ikke nul.
mailbox_state string
Aktuel postkassetilstand: aktiv, pauset, udløbet eller inaktiv.
receiving_enabled boolean
Om denne postkasse i øjeblikket accepterer indgående beskeder.
message_count integer
Kendt samlet beskedantal; den kan afspejle den sidste postkasse‑synkronisering.
unread_message_count integer
Kendt antal ulæste beskeder; den kan afspejle den sidste postkasse-synkronisering.
last_message_received_at string|null
Sidste kendte modtagne-besked tidspunkt i ISO-8601 format, eller null når utilgængelig.
message_count_synced_at string|null
Sidste synkroniseringstid for meddelelsestælling i ISO-8601-format, eller null før synkronisering.
mailbox_limit.limit integer
Aktiv postkassegrænse for denne udbyder; -1 betyder ubegrænset.
mailbox_limit.limit_label string
Visningsetiket for postboksgrænsen.
mailbox_limit.active_count integer
Antal aktive postkasser for denne udbyder.
mailbox_limit.paused_count integer
Antal pausepostkasser for denne udbyder.
mailbox_limit.paused_mailboxes array<string>
Adresser sat på pause på grund af postkassegrænsen.
mailbox_limit.remaining integer
Resterende aktive postkassepladser; -1 betyder ubegrænset. Dette er ikke API-anmodningskvote.
mailbox_limit.remaining_label string
Vis etiket for resterende postkassepladser.
mailbox_limit.reached boolean
Om den aktive postkassegrænse er nået.
mailbox_limit.blocked boolean
Om den aktive postkassegrænse er nul.
mailbox_limit.provider string|null
Udbyder, som postkassegrænsen gælder for.
messages[].id string
Uigennemsigtigt besked‑ID brugt af enkelt‑besked‑, slette‑ og vedhæftnings‑endepunkterne.
messages[].is_seen boolean
Om beskeden er markeret som læst.
messages[].subject string
Meddelelsesemne.
messages[].from string
Afsenders visningsnavn eller adresse.
messages[].from_email string
Afsenderens e‑mailadresse.
messages[].receivedAt string
Modtagelsestid i applikationens tidszone, formateret som YYYY-MM-DD HH:mm:ss.
messages[].otp string|null
Registreret engangskode, når den er tilgængelig og tilladt; ellers null.
messages[].otp_locked boolean
Om en registreret engangskode er skjult af funktionstilladelser.
messages[].verification_link string|null
Registreret verifikations-URL når tilgængelig og tilladt; ellers null.
messages[].verification_link_locked boolean
Om et registreret bekræftelseslink er skjult af funktionstilladelser.
messages[].from_name string|null
Outlook‑oversigtsfelt: oprindeligt afsendernavn. Mangler i Standard‑ og Gmail‑oversigter.
messages[].snippet string|null
Outlook‑sammenfatningsfelt: kort beskedforhåndsvisning.
messages[].received_at string|null
Outlook-sammendragfelt: ISO-8601-modtagelsestid, når den er kendt.
messages[].has_attachments boolean
Outlook-oversigtsfelt: om vedhæftningsmetadata findes. Download-tilgængelighed kontrolleres separat.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

Hent enkeltbesked

Hent en ejet besked ved dens uigennemsigtige besked-ID. Returnerer kropsformater og vedhæftningsmetadata. Kropsfelter afhænger af beskedformatet; Outlook tilføjer leverandørspecifikke felter, der er anført nedenfor.

Parametre 2
Parameter Placering Type Status Beskrivelse
messageId path string påkrævet
Unik besked-ID returneret i meddelelseslisten.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postkasser: brug en read unlock_token. Først POST pin og scope=read til PIN-unlock URL'en. Bevar din normale Bearer-godkendelse. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Læs en besked
curl --request GET \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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:17:49",
        "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"
            }
        ]
    }
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
data.id string
Uigennemsigtig besked‑ID.
data.is_seen boolean
Beskedens læsetilstand. Læsning kan markere den som set; cachelagrede data kan afspejle en tidligere tilstand.
data.subject string
Meddelelsesemne.
data.from string
Afsenders visningsnavn eller adresse.
data.from_email string
Afsenderens e‑mailadresse.
data.to string
Modtagerens postkasseadresse.
data.mailbox_provider string
Postkasseudbyder: standard, gmail_alias eller outlook_alias.
data.receivedAt string
Modtagelsestid i applikationens tidszone, formateret som YYYY-MM-DD HH:mm:ss.
data.html boolean
Om beskeden har en HTML-body.
data.html_content string
HTML-body når til stede. Standardmeddelelser uden HTML kan udelade dette felt. Betragt meddelelsens indhold som upålideligt.
data.text_content string
Tekstkrop, når den er til stede; Standardmeddelelser kan indeholde undsluppet tekst i et pre-element eller udelade dette felt.
data.content string
Foretrukken krop til visning, normalt HTML når den er tilgængelig.
data.attachments array
Vedhæftningsmetadata eller et tomt array. Downloads kræver normal godkendelse og relevant PIN-autorisation.
data.attachments[].name string
Filnavn, der skal URL‑kodet som et enkelt sti‑segment ved download.
data.attachments[].size integer
Vedhæftningsstørrelse i bytes.
data.attachments[].url string
Godkendt bruger API-download-URL tilføjet til vedhæftninger med et filnavn. En URL garanterer ikke, at den lokale fil er tilgængelig.
data.attachments[].extension string
Standard/Gmail-metadatafelt: filendelse, når den er angivet.
data.attachments[].id string
Outlook-metadatafelt: leverandørens vedhæftnings‑ID.
data.attachments[].content_type string
Outlook-metadatafelt: MIME-indholdstype.
data.from_name string|null
Outlook-detaljefelt: oprindeligt afsendernavn.
data.to_email string|null
Outlook-detaljefelt: original modtageradresse.
data.received_at string|null
Outlook-detaljefelt: ISO-8601 modtagelsestid.
data.has_html boolean
Outlook-detaljefelt: om der findes en HTML-body.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Slet besked

Slet en enkelt ejet besked.

Parametre 3
Parameter Placering Type Status Beskrivelse
messageId path string påkrævet
Unik besked-ID-streng til permanent sletning.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postkasser: brug den engangs‑slet‑unlock_token. Først POST pin, scope=delete og den action/target_id, der returneres af 423‑svaret til PIN‑unlock‑URL’en. Et læse‑token kan ikke slette. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Idempotency-Key header string valgfri
Påkrævet for PIN-beskyttet oprettelse eller sletning: en stabil nøgle på 16 til 128 tegn. Gentag den identiske anmodning med den samme nøgle for at undgå dobbelt arbejde.
Slet en besked
curl --request DELETE \
  --url 'https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke felter.

Eksempel på svar
200 OK • JSON
{
    "status": true,
    "message": "Message was deleted successfully."
}
Svarfelter
Felt Type Beskrivelse
status boolean
Om operationen lykkedes.
message string
Resultat af sletningen. En manglende ressource returnerer HTTP 404.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Download vedhæftning

Hent en vedhæftning fra en ejendom besked.

Parametre 3
Parameter Placering Type Status Beskrivelse
messageId path string påkrævet
ID på beskeden, der indeholder filen.
filename path string påkrævet
Filnavn og filendelse på vedhæftningen, der skal downloades.
X-Mailbox-Unlock header string valgfri
Header, kun beskyttede postkasser: brug en read unlock_token. Først POST pin og scope=read til PIN-unlock URL'en. Bevar din normale Bearer-godkendelse. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
Succes returnerer filbytes, ikke JSON. For store filer returnerer HTTP 403; manglende eller utilgængelige lokale filer returnerer HTTP 404. URL-encode filnavnet som et enkelt stisegment. Vedhæftningsmetadata alene garanterer ikke downloadtilgængelighed.
Hent en vedhæftning
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
Downloadadfærd Dette endpoint returnerer den anmodede fil direkte i stedet for en JSON-brødtekst.
Svarfelter
Felt Type Beskrivelse
Content-Disposition header
Succesfuld respons downloader den anmodede filnavn.
body binary
Filbytes ved succes, ikke JSON. Fejl returnerer JSON med en status, der ikke er 2xx.

Ratebegrænsninger & Kvoter

Overvåg realtids-anmodningsbudgetter, hastighedsgrænser og kontokvoter uden at forbruge kreditter.

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

Ratebegrænsning & Kvote

Kontroller din aktuelle hastighedsgrænse og kvotestatus uden at forbruge nogen API-brug. Dette endpoint er kvotefrit og trækker ikke månedlige API-kreditter fra (misbrugsbeskyttelsesgrænse: 60 anmodninger/min).

X-RateLimit-* beskriver det angivne anmodningsbudget; X-Quota-* beskriver månedlig og købt kapacitet når tilgængelig. X-Mailbox-RateLimit-* rapporterer det separate postkasse‑oprettelses/opdateringsbudget. En afvisning kun for postkasse bruger postkasse‑omfang og sit eget genforsøgs‑vindue. Minut‑grænse‑afvisninger kan udelade kvoteinformation. Retry-After inkluderes kun for et tidsbestemt genforsøg; deaktiveret adgang kan kræve en kontoændring. I denne succesfulde statusrespons beskriver data.limit, data.remaining og data.reset kontots minutbudget, ikke brugbare kreditter. data.quota-objektet beskriver månedlig tilladelse, kreditbalancer og forbrug. De eksisterende felter data.monthly_limit, data.monthly_remaining og data.purchased_credits forbliver aliaser til de tilsvarende kvote-felter. En vellykket statuskontrol autoriserer ikke en anden API‑operation. Operationer kræver stadig aktiveret adgang, tilgængelig kvote og godkendelse gennem alle gældende begrænsninger. Kvotesnapshottet lover ikke kapacitet, der allerede er reserveret af en igangværende anmodning.
Kontroller status for hastighedsbegrænsning
curl --request GET \
  --url 'https://v1.tempmailg.com/api/rate-limit' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_USER_API_KEY'

Illustrativt svar ved brug af syntetiske data. ID'er, adresser, tokens, tidsstempler, plan‑grænser og tællere varierer. Eksempel‑levetider overskriver ikke din plans standardindstilling. Beskrivelsen af svarfelterne identificerer nullbare og udbyderspecifikke 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"
        }
    }
}
Svarfelter
Felt Type Beskrivelse
data.limit integer|string
Kontoens anmodninger-per-minut grænse. Strengen unlimited betegner et ubegrænset minutbudget; dette er uafhængigt af den månedlige kvote.
data.remaining integer|string
Resterende kontominutbudgetpladser, eller strengen unlimited. En positiv værdi betyder ikke, at API‑kreditterne forbliver.
data.reset integer
Sekunder for kontoens minutvindue, ikke den månedlige kvote nulstilling. Deaktiverede eller ubegrænsede minutbudgetter kan beholde en nominel værdi på 60 sekunder; dette lover ikke adgang efter ventetid.
data.plan string
Aktuel plan-tag. Det læsbare planenavn leveres separat i data.quota.plan_name.
data.quota.enabled boolean
Om global og plan/kredit API-adgang er aktiveret. Dette angiver ikke resterende kapacitet eller erstatter brugerens API-omskifter.
data.quota.user_api_status boolean
Om brugeren har aktiveret deres User API‑knap. Operationer kræver denne knap samt aktiveret adgang og tilgængelig kapacitet.
data.quota.plan_name string
Læseligt navn på den aktuelle plan.
data.quota.period string
Kalendermånedens brugsperiode i formatet YYYY-MM, med brug af applikationens tidszone; ikke nødvendigvis abonnementets faktureringsperiode.
data.quota.base_limit integer
Basis månedlig plankvote. En værdi på -1 betyder ubegrænset.
data.quota.extra_requests integer
Yderligere månedlig kvote tildelt for den aktuelle brugsperiode; adskilt fra købte kreditter.
data.quota.monthly_limit integer
Basis kvote plus ekstra anmodninger i den aktuelle periode. En værdi på -1 betyder ubegrænset. Købte kreditter er ikke inkluderet.
data.quota.monthly_remaining integer|null
Resterende endelige månedlige kvote, eller null når den månedlige kvote er ubegrænset. Null må ikke fortolkes som nul.
data.quota.used integer
Succesfulde, tællede API‑operationer i den aktuelle brugperiode, inklusive operationer, der bruger kreditter. Statuskontroller øger ikke denne værdi.
data.quota.purchased_credits integer
Aktuel kreditbalance, inklusive bonuskreditter for aktiv plan. Bonuskreditter må ikke tilføjes denne balance en anden gang.
data.quota.bonus_credits integer
Aktiv plan-bonusdel af kreditbalancen; en opdeling af purchased_credits, ikke ekstra kapacitet.
data.quota.direct_purchased_credits integer
Kreditbalance ekskluderet den aktive plan-bonusdel. Denne værdi plus bonus_credits svarer til purchased_credits.
data.quota.remaining integer|null
Månedlig resterende kvote plus den aktuelle kreditbalance, uden at tælle bonusser dobbelt. Null betyder ubegrænset månedlig kvote. Individuelle funktionstilladelser og andre anmodningsgrænser gælder stadig.
data.quota.unlimited boolean
Om den månedlige kvote er ubegrænset. Dette gør ikke kontoens minutbudget eller andre funktionsgrænser ubegrænsede.
data.quota.usage_percent integer
Dashboard-kompatibel afrundet procent fra 0 til 100: brugt divideret med brugt plus resterende, multipliceret med 100. Den inkluderer tilgængelig kreditkapacitet, så genopladning kan sænke procenten. Den er 0 for ubegrænset kvote eller en pulje på nul størrelse; den er ikke minut‑rate‑begrænsningsprocenten eller en adgangsbeslutning.
data.quota.reset_at string
ISO-8601-tidsstempel med tidszoneoffset for den næste kalendermånedens kvotenulstilling. Dette er ikke abonnementets udløbsdato, og den månedlige nulstilling genopfylder ikke købte kreditter.
status string
Den bogstavelige succes for dette status-endpoint. Andre succesfulde postkasse-endpoints bruger den boolske sand.
data.monthly_limit integer
Kompatibilitetsalias for det tilsvarende data.quota-felt; tilføj det ikke igen, når du beregner saldi.
data.monthly_remaining integer|null
Kompatibilitetsalias for det tilsvarende data.quota-felt; tilføj det ikke igen, når du beregner saldi.
data.purchased_credits integer
Kompatibilitetsalias for det tilsvarende data.quota-felt; tilføj det ikke igen, når du beregner saldi.

Postkasse PIN-beskyttelse

Indtast PIN-koden for at fortsætte. Din postkasse forbliver låst op, så længe den er aktiv i denne websidesession.

Accepter du cookies?

Vi bruger cookies for at forbedre din browseroplevelse. Ved at bruge dette site accepterer du vores cookiepolitik.

Mere