Hurtig opsætningsliste
- Åbn din dashboard API-styring side og opret din personlige API-nøgle.
- Kopier den præcise Bruger-API-basen-URL, der vises der, f.eks. https://v1.tempmailg.com/api.
- Send hver anmodning til denne API-vært med Authorization: Bearer YOUR_USER_API_KEY og Accept: application/json.
- Følg din månedlige anmodningskvote fra den samme dashboard-side og fra kvote‑headers, når de er tilgængelige i bruger‑API‑svar. Kun succesfulde 2xx‑anmodninger tæller med i kvoten.
API-nøgleadgang
Log ind for at oprette din personlige API-nøgle og se live kvoteoplysninger.
Godkendelsesflow
- Generer din personlige API-nøgle fra dashboard-API-Management-siden.
- Send nøglen som en Bearer-token i hver anmodning.
- Brug den dedikerede Bruger-API-basen URL, der vises på din API-Management-side.
- Generer nøglen på ny, når du gerne vil ugyldiggøre den gamle og starte med at bruge en ny nøgle med det samme.
Krævede headers
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Ratebegrænsning & kvote‑overskrifter
Rate-limit-headers beskriver det angivne anmodningsbudget. Kvote-headers er inkluderet, når kvoteinformation er tilgængelig; minut-grænse-afvisninger beregner ikke din fulde månedlige kvote.
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1729520000
X-Quota-Limit: 50000
X-Quota-Remaining: 48210
X-Quota-Used: 1790
X-Quota-Reset: 2026-11-01T00:00:00+00:00
X-RateLimit-Scope: account
Retry-After: 42 (when a timed retry is available)
X-RateLimit-Limit— Maksimalt tilladte anmodninger pr. minut (RPM) for din plan.X-RateLimit-Remaining— RPM-anmodninger tilbage i det aktuelle minutvindue.X-RateLimit-Reset— Unix-tidsstempel, når det aktuelle minutters hastighedsgrænsevindue nulstilles.X-Quota-Limit— Den samlede månedlige og købte kreditkapacitet for din konto.X-Quota-Remaining— Resterende tilgængelige API-anmodninger i den aktuelle måned.X-Quota-Used— Totalt antal API-anmodninger forbrugt i den aktuelle faktureringsperiode.X-Quota-Reset— ISO-8601-tidsstempel, når din månedlige kvote nulstilles.X-RateLimit-Scope— Budgettet beskrevet af overskrifterne: account, ip, status_endpoint eller mailbox.X-Mailbox-RateLimit-*— Separat postkasseoprettelses-/opdateringsbudget. Succesfulde postkasse‑svar bevarer konto‑RPM i X-RateLimit-*; en postkasse‑kun afvisning bruger postkasse‑omfang og sit eget genforsøgs‑vindue.Retry-After— Sekunder indtil et tidsbestemt genforsøg er passende. En deaktiveret plan eller udtømt kvote kan i stedet kræve en kontoændring, så denne header er ikke altid til stede.503 protection_unavailable— API-beskyttelseslagring eller -koordinering er midlertidigt utilgængelig. Prøv igen senere; dette er ikke en betalingsfejl eller en kreditdebitering.
Postkasseadministration
Hent tilladte domæner, opret eller skift postkasser, vælg tilladte levetider, og slet ejede adresser.
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.
| 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
|
const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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
}
]
}
}
| 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. |
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.
| 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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
}
| 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. |
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.
| 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>
|
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.const response = await fetch('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/current@example.com/demo123/example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
}
| 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. |
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.
| 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.
|
const response = await fetch('https://v1.tempmailg.com/api/emails/demo123@example.com', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/emails/demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/emails/demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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."
}
| 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.
Opret Gmail‑alias
Opret en ny Gmail-alias midlertidig postkasse, som ejes af den godkendte bruger.
| 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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/gmail-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/gmail-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/gmail-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
}
| 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. |
Outlook-aliasdomæner
Hent aktive Outlook / Hotmail alias-domæner, der er tilgængelige for oprettelse af postkasse.
const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/domains', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/outlook-alias/domains', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/domains');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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
}
]
}
}
| 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. |
Opret Outlook-alias
Opret en ny Outlook/Hotmail-alias midlertidig postkasse, som ejes af den godkendte bruger.
| 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.
|
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.const response = await fetch('https://v1.tempmailg.com/api/outlook-alias/emails', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.post('https://v1.tempmailg.com/api/outlook-alias/emails', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/outlook-alias/emails');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
}
| 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.
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.
| 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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages?email=demo123@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages?email=demo123@example.com', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages?email=demo123@example.com');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
| 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. |
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.
| 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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
]
}
}
| 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. |
Slet besked
Slet en enkelt ejet besked.
| 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.
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.delete('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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."
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operationen lykkedes. |
message |
string | Resultat af sletningen. En manglende ressource returnerer HTTP 404. |
Download vedhæftning
Hent en vedhæftning fra en ejendom besked.
| 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>
|
const response = await fetch('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const blob = await response.blob();
const downloadUrl = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = downloadUrl;
link.download = 'file.txt';
document.body.appendChild(link);
link.click();
link.remove();
window.URL.revokeObjectURL(downloadUrl);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt', headers=headers, stream=True, timeout=30)
response.raise_for_status()
with open('file.txt', 'wb') as handle:
for chunk in response.iter_content(chunk_size=8192):
if chunk:
handle.write(chunk)
<?php
$fileHandle = fopen('file.txt', 'w');
$ch = curl_init('https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_FILE => $fileHandle,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
if (curl_exec($ch) === false) {
fclose($fileHandle);
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
fclose($fileHandle);
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
| 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.
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).
const response = await fetch('https://v1.tempmailg.com/api/rate-limit', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/rate-limit', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/rate-limit');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
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"
}
}
}
| 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-webhooks (Echtzeit-Push)
I stedet for gentagne polling af REST-API'en (GET /messages) for at kontrollere efter indgående mail, konfigurer Webhooks til at push nye meddelelser til din server eller automatiseringsworkflow i realtid.
Støttede Webhook-hændelser
Hvert webhook kan abonnere på en eller flere hændelsestypers. Din endpoint modtager en hændelsesmeddelelse hver gang en af disse udløsere aktiveres.
Afsendt i realtid, hver gang en ny besked når den valgte mailboks.
Afsendt når den midlertidige postkasse udløber, og webhook-behandlingen er sat på pause.
Afsendt når en udløbet postkasse igen bliver aktiv under planregler.
Afsendt lige før webhooken og dens postkasse slettes.
Anmodningshoved og HMAC-signaturverifikation
Hvert webhook-levering indeholder særlige sikkerhedshoveder. Brug X-TempMailg-Signature-hovedet til at verifcere, at indgående anmodninger er blevet afsendt ægte af TempMailg og ikke er blevet ændret.
| Overskrift | Eksempelværdi | Beskrivelse |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Standardidentifikator for webhook-leveringsarbejderen. |
X-TempMailg-Event |
email.received | Typen af begivenhed, der udløste denne levering. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Unik UUID tildelt dette leveringsforsøg. |
X-TempMailg-Timestamp |
1725192000 | Unix-epok tidsstempel, der angiver, hvornår anmodningen blev initieret. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | HMAC-SHA256-signatur beregnet ud fra {timestamp}.{raw_body} ved brug af din hemmelighed. |
X-TempMailg-Test |
false | Sandt når den sendes af "Send Test Ping"-funktionen i dit dashboard. |
Underskriften beregnes ved hjælp af HMAC med SHA256 over følgende streng:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Eksempel på Begivenhedsbetydning (email.received)
Levert som application/json i HTTP POST-krop
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:17:50+00:00",
"test": false,
"mailbox": {
"id": 1024,
"email": "developer@v1.tempmailg.com"
},
"data": {
"message_id": "7a8b9c0d1e2f",
"subject": "Your Verification Code: 948201",
"from": "auth@service.com",
"to": "developer@v1.tempmailg.com",
"date": "2026-11-19T02:17:50+00:00",
"attachments_count": 0,
"text_preview": "Hello, your one-time verification code is 948201. It will expire in 10 minutes.",
"email_url": "https://tempmailg.com/mailbox/1024?message=7a8b9c0d1e2f",
"inbox_url": "https://tempmailg.com/mailbox/1024"
}
}
Eksempler på modtagerimplementering
Vælg dit sprog for at se, hvordan du modtager webhooks og verificerer HMAC‑signaturer sikkert.
const express = require('express');
const crypto = require('crypto');
const app = express();
const WEBHOOK_SECRET = 'your_webhook_signing_secret';
// Capture raw body buffer for HMAC-SHA256 signature verification
app.use(express.json({
verify: (req, res, buf) => {
req.rawBody = buf.toString('utf8');
}
}));
app.post('/webhook', (req, res) => {
const timestamp = req.headers['x-tempmailg-timestamp'];
const signatureHeader = req.headers['x-tempmailg-signature'] || '';
// Calculate HMAC-SHA256 signature
const expectedSignature = 'sha256=' + crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(`${timestamp}.${req.rawBody}`)
.digest('hex');
// Verify signature
if (signatureHeader !== expectedSignature) {
return res.status(401).json({ error: 'Invalid webhook signature' });
}
const { event, mailbox, data } = req.body;
console.log(`[Event: ${event}] Mailbox: ${mailbox.email}`);
if (event === 'email.received') {
console.log(`From: ${data.from}`);
console.log(`Subject: ${data.subject}`);
console.log(`Preview: ${data.text_preview}`);
}
// Acknowledge receipt with HTTP 200
res.status(200).json({ received: true });
});
app.listen(3000, () => console.log('Webhook receiver running on port 3000'));
from flask import Flask, request, jsonify
import hmac
import hashlib
app = Flask(__name__)
WEBHOOK_SECRET = b"your_webhook_signing_secret"
@app.route("/webhook", methods=["POST"])
def handle_webhook():
timestamp = request.headers.get("X-TempMailg-Timestamp", "")
signature_header = request.headers.get("X-TempMailg-Signature", "")
# Calculate expected HMAC-SHA256 signature
raw_body = request.get_data()
signed_payload = f"{timestamp}.".encode("utf-8") + raw_body
expected_signature = "sha256=" + hmac.new(
WEBHOOK_SECRET, signed_payload, hashlib.sha256
).hexdigest()
# Verify signature securely
if not hmac.compare_digest(signature_header, expected_signature):
return jsonify({"error": "Invalid signature"}), 401
payload = request.get_json()
event = payload.get("event")
mailbox = payload.get("mailbox", {}).get("email")
data = payload.get("data", {})
print(f"[{event}] Mailbox: {mailbox}")
if event == "email.received":
print(f"From: {data.get('from')}")
print(f"Subject: {data.get('subject')}")
print(f"Preview: {data.get('text_preview')}")
# Return 200 OK to acknowledge receipt
return jsonify({"received": True}), 200
if __name__ == "__main__":
app.run(port=5000)
<?php
$secret = 'your_webhook_signing_secret';
$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_TEMPMAILG_TIMESTAMP'] ?? '';
$receivedSignature = $_SERVER['HTTP_X_TEMPMAILG_SIGNATURE'] ?? '';
// Calculate HMAC-SHA256 signature
$expectedSignature = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
// Verify signature
if (!hash_equals($expectedSignature, $receivedSignature)) {
http_response_code(401);
echo json_encode(['error' => 'Invalid signature']);
exit;
}
$payload = json_decode($rawBody, true);
$event = $payload['event'] ?? '';
$mailbox = $payload['mailbox']['email'] ?? '';
$data = $payload['data'] ?? [];
if ($event === 'email.received') {
$sender = $data['from'] ?? '';
$subject = $data['subject'] ?? '';
$preview = $data['text_preview'] ?? '';
// Process new incoming email...
}
// Acknowledge receipt
http_response_code(200);
echo json_encode(['received' => true]);
Understøttede platforme og automatiseringsintegrationer
TempMailg Webhooks fungerer ud af boksen med standard HTTPS-endpoints og førende no-code/automatiseringsplatforme:
Almindelige fejl og fejlfinding
Disse er de mest almindelige svarkoder, du kan se, mens du integrerer bruger-API'en.
Ugyldig, manglende eller tilbagekaldt Bearer-token.
Ejerskab, funktionstilladelser, domænetilgængighed eller vedhæftningsstørrelse forhindrede handlingen. Tjek svar‑koden og beskeden.
Ressourcen blev ikke fundet på den tilladte vært eller tilhører ikke brugeren.
Operatørenøglen blev genbrugt med andre detaljer, en anden operation er i ventetilstand, eller postkassens sikkerhed er ændret. Inspicer koden, før du prøver igen.
Postkasse er udløbet eller inaktiv.
Ugyldige parametre, en ikke tilladt levetid, utilgængelig aliaskapacitet, ugyldig PIN-konfiguration eller en manglende/ugyldig Idempotency-Key forhindrede handlingen.
En beskyttet postkasse kræver et gyldigt scoped X-Mailbox-Unlock-token. Brug action og target_id fra svaret til sletning. Låse‑ eller gendannelseskrav skal løses, før du prøver igen.
En anmodningsgrænse, deaktiveret plan, udtømt kvote eller cooldown forhindrede handlingen. Tjek årsagen og tilgængelige budget‑overskrifter. Retry-After er valgfri.
Serveren kunne ikke fuldføre handlingen. For beskyttet oprettelse eller sletning skal du bevare den samme anmodning og Idempotency-Key, når du prøver igen.
Beskytelseslagring eller koordinering kunne ikke bekræftes. Prøv igen efter den angivne forsinkelse. Dette svar er ikke en mislykket betaling.
Hurtig tjekliste
- 401 Unauthorized - Bearer-token mangler, er forkert, tilbagekaldt eller kopieret forkert.
- 403 Forbidden - Den nuværende plan har ikke bruger-API-adgang lige nu.
- 404 Not Found - Ressource ikke fundet eller ugyldig parameter
- 410 Gone / Expired - Postkassen er udløbet eller er ikke længere aktiv.
- 429 Rate Limited - Kontroller svarårsagen og budget‑headere. Retry-After gælder kun for tidsbegrænsninger; udtømte kreditter eller deaktiveret adgang kan kræve en kontoskift.
Anbefalet næste skridt
Hvis du er logget ind, åbn API Management først og bekræft din nøgle, kvote, planadgangsstatus og den præcise bruger-API-basen URL, før du fejlfinder din eksterne app.