Hurtig oppsett-sjekkliste
- à pne dashbord-siden API-hÄndtering og opprette din personlige API-nÞkkel.
- Kopier den eksakte Bruker-API-basen-URL som vist der, for eksempel https://v1.tempmailg.com/api.
- Send hver forespĂžrsel til den API-vert med Authorization: Bearer YOUR_USER_API_KEY og Accept: application/json.
- Spor din mĂ„nedlige forespĂžrselskvote fra samme dashbordside og fra kvoteâoverskrifter nĂ„r de er tilgjengelige i brukerâAPIâsvar. Kun vellykkede 2xxâforespĂžrsler teller mot kvoten.
API-nĂžkkeltilgang
Logg inn for Ă„ opprette din personlige API-nĂžkkel og vis live kvote-detaljer.
Autentiseringsflyt
- Generer din personlige API-nÞkkel fra dashboard-API-hÄndteringssiden.
- Send nĂžkkelen som en Bearer-token i hver forespĂžrsel.
- Bruk den dedikerte bruker-API-basen URL som vist pÄ din API-hÄndteringsside.
- Generer nÞkkelen pÄ nytt nÄr du Þnsker Ä gjÞre den gamle ugyldig og starte Ä bruke en ny nÞkkel med en gang.
Obligatoriske header
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Ratebegrensning & Kvote Overskrifter
Rateâlimitâoverskrifter beskriver det angitte forespĂžrselsbudsjettet. Kvoteâoverskrifter er inkludert nĂ„r kvoteinformasjon er tilgjengelig; avvisninger pĂ„ minuttâgrense beregner ikke din fullstendige 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 antall forespĂžrsler per minutt (RPM) for planen din.X-RateLimit-Remaining— RPM-forespĂžrsler gjenstĂ„r i det nĂ„vĂŠrende minuttvinduet.X-RateLimit-Reset— Unix-tidsstempel nĂ„r det nĂ„vĂŠrende minutts takgrensevinduet tilbakestilles.X-Quota-Limit— Total mĂ„nedlig og kjĂžpt kredittkapasitet for kontoen din.X-Quota-Remaining— GjenvĂŠrende tilgjengelige API-forespĂžrsler i innevĂŠrende mĂ„ned.X-Quota-Used— Totalt antall API-forespĂžrsler forbrukt i den nĂ„vĂŠrende faktureringsperioden.X-Quota-Reset— ISO-8601 tidsstempel nĂ„r din mĂ„nedlige kvote tilbakestilles.X-RateLimit-Scope— Budsjettet beskrevet av overskriftene: account, ip, status_endpoint, eller mailbox.X-Mailbox-RateLimit-*— Separat budsjett for opprettelse/oppdatering av postboks. Vellykkede postboksrespons beholder konto RPM i X-RateLimit-*; en avvisning kun for postboks bruker postboksens omfang og sitt eget gjenforsĂžkvindu.Retry-After— Sekunder til et tidsbestemt gjenforsĂžk er passende. En deaktivert plan eller oppbrukt kvote kan kreve en kontobytt i stedet, sĂ„ denne overskriften er ikke alltid til stede.503 protection_unavailable— API-beskyttelseslagring eller koordinering er midlertidig utilgjengelig. PrĂžv igjen senere; dette er ikke en betalingsfeil eller en kredittdebet.
Postboksadministrasjon
Hent tillatte domener, opprett eller bytt postbokser, velg tillatte levetider, og slett eide adresser.
List opp tillatte domener
List opp tilgjengelige domener for Ă„ opprette midlertidige eâposter. Filtrer etter type for kun Ă„ se gratis, premium eller tilpassede domener som stĂžttes av abonnementet ditt.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
type
|
query | string | valgfri |
Domene-nivÄfilter. Utelatelse bruker alle nÄr premium-domene tilgang er aktivert, ellers gratis. Gjenkjente verdier: free, basic, pro, premium, custom, ultimate, all
Standard:
Kontoavhengig
|
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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"data": {
"requested_type": "free",
"plan": "pro",
"plan_name": "Pro Plan",
"allowed_types": [
"free",
"basic",
"pro",
"premium",
"custom",
"ultimate",
"all"
],
"domains": [
{
"domain": "example.com",
"type": "Free",
"custom": false
}
]
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
data.requested_type |
string | PÄfÞrt domenefilter. |
data.plan |
string | NÄvÊrende planetikett. |
data.plan_name |
string | Lesbart navn pÄ gjeldende plan. |
data.allowed_types |
array<string> | Domene-filtre tilgjengelig for denne kontoen. Et gjenkjent filter kan fortsatt vĂŠre forbudt for din plan. |
data.domains |
array | Valgbare domener etter filtrering; en tom array er gyldig. |
data.domains[].domain |
string | Velgbart domenenavn. |
data.domains[].type |
string | Lesbar domenenivÄetikett. |
data.domains[].custom |
boolean | Om dette er et egendefinert domene. |
Opprett midlertidig postkasse
Opprett en eid midlertidig postboks. Utelat brukernavn og domene for tilfeldig generering, eller oppgi et tillatt tilpasset brukernavn og et tillatt domene. Provider-parameteren kan velge Gmail- eller Outlook-aliasgenerering.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
username
|
body | string | valgfri |
Valgfritt tilpasset brukernavn: 2 til 64 ASCII-bokstaver, tall, punktum, understrek eller bindestreker. Krever planrettighet; custom_username aksepteres ogsÄ.
Standard:
Tilfeldig generert
|
domain
|
body | string | valgfri |
En av de tillatte domenene som returneres av GET /domains. Utelatelse velger et tilfeldig tillatt domene.
Standard:
Tilfeldig tillatt domene
|
lifetime
|
body | string | valgfri |
tillatte verdier:
10m — 10 minutter
1h — 1 Time
2h — 2 timer
1d — 1 dag
1w — 1 Uke
1m — 30 dager
3m — 90 dager
6m — 180 dager
1y — 365 dager
unlimited — Ubegrenset
Standard:
Planens standard levetid
|
provider
|
body | string | valgfri |
PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias.
Standard:
standard
|
pin_enabled
|
body | boolean | valgfri |
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard:
false
|
pin
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
|
pin_confirmation
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
|
Idempotency-Key
|
header | string | valgfri |
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
|
username (tilpasset brukernavn hvis tillatt av planen), domain (tillatt domene, f.eks. example.com), lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"data": {
"id": 2301,
"pin_protected": false,
"email": "demo123@example.com",
"domain": "example.com",
"provider": "standard",
"expire_at": "2026-11-20T02:18:07+00:00",
"expires_in_seconds": 86399.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:18:07+00:00",
"email_token": "encrypted-email-token"
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
data.id |
integer | Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks. |
data.pin_protected |
boolean | Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres. |
data.email |
string | Generert full postboksadresse. |
data.domain |
string | Domene for den genererte postboksen. |
data.provider |
string | PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias. |
data.expire_at |
string|null | Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks. |
data.expires_in_seconds |
number|null | Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null. |
data.mailbox_state |
string | Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv. |
data.receiving_enabled |
boolean | Om denne postkassen for Ăžyeblikket godtar innkommende meldinger. |
data.message_count |
integer | Kjent total meldingstell; den kan gjenspeile den siste postboksâsynkroniseringen. |
data.unread_message_count |
integer | Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen. |
data.last_message_received_at |
string|null | Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig. |
data.message_count_synced_at |
string|null | Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering. |
data.created_at |
string|null | Postboksens opprettelsestid i ISO-8601-format. |
data.email_token |
string | Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering. |
data.pin_grant |
object | Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den. |
data.pin_grant.mailbox_id |
integer | Postkasse-ID som den betingede lesetillatelsen er knyttet til. |
data.pin_grant.unlock_token |
string | Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting. |
data.pin_grant.scope |
string | Omfanget lest for den betingede opprettelsesbevilgningen. |
data.pin_grant.idle_timeout_seconds |
integer | Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder. |
data.pin_grant.absolute_timeout_seconds |
integer | Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder. |
data.pin_grant.expires_at |
string | Gjeldende utlĂžp for lesetillatelse i ISO-8601-format. |
data.pin_grant.absolute_expires_at |
string | Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere. |
Oppdater / Bytt postkasse
Opprett eller velg en postboks pÄ det nye brukernavnet og domenet etter Ä ha bekreftet eierskap til den nÄvÊrende postboksen. Dette gir ikke nytt navn til den gamle postboksen eller endrer dens levetid pÄ stedet. NÄr destinasjonen er forskjellig, forblir den gamle postboksen i historikken og kan bli satt pÄ pause av aktive postboksbegrensninger. Gjenbruk av din egen aktive destinasjon pÄfÞrer dens forespurte levetid eller standardplan.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
email
|
path | string | pÄkrevd |
Gjeldende fullstendige e-postadresse til den eide postkassen som skal byttes. URL-encode hver sti-segment; kod et pluss-tegn som %2B.
|
username
|
path | string | pÄkrevd |
Nytt Ăžnsket brukernavn: 2 til 64 alfanumeriske tegn; underlagt tillatelse for egendefinert brukernavn.
|
domain
|
path | string | pÄkrevd |
Nytt tillatt domenenavn.
|
lifetime
|
body | string | valgfri |
tillatte verdier:
10m — 10 minutter
1h — 1 Time
2h — 2 timer
1d — 1 dag
1w — 1 Uke
1m — 30 dager
3m — 90 dager
6m — 180 dager
1y — 365 dager
unlimited — Ubegrenset
Standard:
Planens standard levetid
|
pin_enabled
|
body | boolean | valgfri |
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard:
false
|
pin
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
|
pin_confirmation
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
|
Idempotency-Key
|
header | string | valgfri |
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
|
X-Mailbox-Unlock
|
header | string | valgfri |
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"data": {
"id": 2302,
"pin_protected": false,
"email": "demo123@example.com",
"domain": "example.com",
"provider": "standard",
"expire_at": "2026-11-19T02:28:07+00:00",
"expires_in_seconds": 599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:18:07+00:00",
"email_token": "encrypted-email-token"
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
data.id |
integer | Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks. |
data.pin_protected |
boolean | Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres. |
data.email |
string | Generert full postboksadresse. |
data.domain |
string | Domene for den genererte postboksen. |
data.provider |
string | PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias. |
data.expire_at |
string|null | Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks. |
data.expires_in_seconds |
number|null | Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null. |
data.mailbox_state |
string | Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv. |
data.receiving_enabled |
boolean | Om denne postkassen for Ăžyeblikket godtar innkommende meldinger. |
data.message_count |
integer | Kjent total meldingstell; den kan gjenspeile den siste postboksâsynkroniseringen. |
data.unread_message_count |
integer | Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen. |
data.last_message_received_at |
string|null | Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig. |
data.message_count_synced_at |
string|null | Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering. |
data.created_at |
string|null | Postboksens opprettelsestid i ISO-8601-format. |
data.email_token |
string | Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering. |
data.pin_grant |
object | Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den. |
data.pin_grant.mailbox_id |
integer | Postkasse-ID som den betingede lesetillatelsen er knyttet til. |
data.pin_grant.unlock_token |
string | Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting. |
data.pin_grant.scope |
string | Omfanget lest for den betingede opprettelsesbevilgningen. |
data.pin_grant.idle_timeout_seconds |
integer | Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder. |
data.pin_grant.absolute_timeout_seconds |
integer | Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder. |
data.pin_grant.expires_at |
string | Gjeldende utlĂžp for lesetillatelse i ISO-8601-format. |
data.pin_grant.absolute_expires_at |
string | Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere. |
Slett postboks
Slett en eiet postboks og start opprydding av meldinger og filer. Bevarte postboksposter kan bli mykt slettet internt; adressen er ikke lenger brukbar via API-et.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
email
|
path | string | pÄkrevd |
Full eâpostadresse til den eide postboksen som skal slettes. URLâkod adressen; kod et plussâtegn som %2B.
|
X-Mailbox-Unlock
|
header | string | valgfri |
Header, kun beskyttede postbokser: bruk den engangsâdeleteâunlock_token. FĂžrst POST pin, scope=delete og action/target_id som returneres av 423âresponsen til PINâunlockâURLen. Et lesetoken kan ikke slette. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | valgfri |
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
|
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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"message": "Email has been successfully deleted."
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
message |
string | Resultat av slettingen. En manglende ressurs returnerer HTTP 404. |
Gmail og Outlook-aliaser
Generer e-postbokser med hĂžy omdĂžmme for Gmail- og Outlook/Hotmail-aliaser.
Opprett Gmailâalias
Opprett en ny Gmail-alias midlertidig postboks som eies av den autentiserte brukeren.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
mode
|
body | string | valgfri |
Generasjonsmodus: auto, dot, plus eller plus_dot. Godtar ogsÄ gmail_alias_mode. Hvis stilvalg ikke er tillatt, brukes auto.
Standard:
auto
|
username
|
body | string | valgfri |
Valgfritt egendefinert alias-suffiks: 2 til 32 ASCII-bokstaver eller sifre, normalisert til smÄ bokstaver; underlagt funksjonstillatelse. Godtar ogsÄ custom_username eller alias_username.
Standard:
Automatisk generert
|
domain
|
body | string | valgfri |
Bruk tilfeldig, gmail.com eller googlemail.com; alias_domain aksepteres ogsĂ„. Ommisjon eller utilgjengelig domeneâvalg tillatelse bruker tilfeldig.
Standard:
random
|
lifetime
|
body | string | valgfri |
tillatte verdier:
10m — 10 minutter
1h — 1 Time
2h — 2 timer
1d — 1 dag
1w — 1 Uke
1m — 30 dager
3m — 90 dager
6m — 180 dager
1y — 365 dager
unlimited — Ubegrenset
Standard:
Planens standard levetid
|
pin_enabled
|
body | boolean | valgfri |
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard:
false
|
pin
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
|
pin_confirmation
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
|
Idempotency-Key
|
header | string | valgfri |
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
|
mode (auto, dot, plus, plus_dot), username (tilpasset alias brukernavn), domain (f.eks. gmail.com, googlemail.com), lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"data": {
"id": 2305,
"pin_protected": false,
"email": "example+alias123@gmail.com",
"domain": "gmail.com",
"provider": "gmail_alias",
"expire_at": "2026-11-19T03:18:07+00:00",
"expires_in_seconds": 3599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:18:07+00:00",
"email_token": "encrypted-email-token"
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
data.id |
integer | Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks. |
data.pin_protected |
boolean | Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres. |
data.email |
string | Generert full postboksadresse. |
data.domain |
string | Domene for den genererte postboksen. |
data.provider |
string | PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias. |
data.expire_at |
string|null | Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks. |
data.expires_in_seconds |
number|null | Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null. |
data.mailbox_state |
string | Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv. |
data.receiving_enabled |
boolean | Om denne postkassen for Ăžyeblikket godtar innkommende meldinger. |
data.message_count |
integer | Kjent total meldingstell; den kan gjenspeile den siste postboksâsynkroniseringen. |
data.unread_message_count |
integer | Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen. |
data.last_message_received_at |
string|null | Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig. |
data.message_count_synced_at |
string|null | Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering. |
data.created_at |
string|null | Postboksens opprettelsestid i ISO-8601-format. |
data.email_token |
string | Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering. |
data.pin_grant |
object | Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den. |
data.pin_grant.mailbox_id |
integer | Postkasse-ID som den betingede lesetillatelsen er knyttet til. |
data.pin_grant.unlock_token |
string | Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting. |
data.pin_grant.scope |
string | Omfanget lest for den betingede opprettelsesbevilgningen. |
data.pin_grant.idle_timeout_seconds |
integer | Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder. |
data.pin_grant.absolute_timeout_seconds |
integer | Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder. |
data.pin_grant.expires_at |
string | Gjeldende utlĂžp for lesetillatelse i ISO-8601-format. |
data.pin_grant.absolute_expires_at |
string | Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere. |
Outlook Alias-domener
Hent aktive Outlook / Hotmail alias-domener som er tilgjengelige for opprettelse av postboks.
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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"data": {
"domains": [
{
"domain": "outlook.com",
"type": "Outlook/Hotmail",
"selectable": true,
"locked": false,
"disabled_reason": null
},
{
"domain": "hotmail.com",
"type": "Outlook/Hotmail",
"selectable": true,
"locked": false,
"disabled_reason": null
}
]
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
data.domains |
array | Aktive Outlook/Hotmail-domener; et tomt array er gyldig. |
data.domains[].domain |
string | Tilgjengelig domenenavn. |
data.domains[].type |
string | Lesbar leverandĂžretikett. |
data.domains[].selectable |
boolean | Om kontoen din kan velge dette domenet eksplisitt. |
data.domains[].locked |
boolean | Om eksplisitt domenevalg er lÄst for kontoen din. |
data.domains[].disabled_reason |
string|null | Ă
rsak til at domenvalg er lÄst, eller null nÄr det er valgbart. |
Opprett Outlook-alias
Opprett en ny Outlook / Hotmail-alias midlertidig postboks som eies av den autentiserte brukeren.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
domain
|
body | string | valgfri |
Bruk tilfeldig eller et domene fra GET /outlook-alias/domains; outlook_alias_domain aksepteres ogsÄ. Uten valgrettighet brukes tilfeldig.
Standard:
Tilfeldig tilgjengelig domene
|
username
|
body | string | valgfri |
Valgfritt egendefinert alias-suffiks: 2 til 32 ASCII-bokstaver eller sifre, normalisert til smÄ bokstaver; underlagt funksjonstillatelse. Godtar ogsÄ custom_username eller alias_username.
Standard:
Automatisk generert
|
lifetime
|
body | string | valgfri |
tillatte verdier:
10m — 10 minutter
1h — 1 Time
2h — 2 timer
1d — 1 dag
1w — 1 Uke
1m — 30 dager
3m — 90 dager
6m — 180 dager
1y — 365 dager
unlimited — Ubegrenset
Standard:
Planens standard levetid
|
pin_enabled
|
body | boolean | valgfri |
Valgfri PIN-beskyttelse for den nye postkassen, nÄr det er tillatt av planen din. Den endrer ikke PIN-koden for en eksisterende postkasse.
Standard:
false
|
pin
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er sann: en PIN pÄ 6 til 8 sifre, sendt som en streng for Ä bevare ledende nuller.
|
pin_confirmation
|
body | string | valgfri |
PÄkrevd nÄr pin_enabled er true. MÄ nÞyaktig samsvare med pin.
|
Idempotency-Key
|
header | string | valgfri |
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
|
domain (f.eks. outlook.com, hotmail.com), username (tilpasset alias brukernavn), lifetime (tillatte verdier: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Utelat levetid, eller la den stÄ tom, for Ä bruke standard e-postlevetid konfigurert for ditt nÄvÊrende mÄnedlige/Ärlige abonnement. Send en tillatt levetid, for eksempel 1t, for Ä overstyre standardverdien. Ubegrenset brukes kun nÄr det er konfigurert som standard for abonnementet eller eksplisitt forespurt og tillatt. Kroppsparametere mailbox_lifetime og email_lifetime aksepteres ogsÄ; den fÞrste ikke-tomme verdien vinner i denne rekkefÞlgen: lifetime, mailbox_lifetime, email_lifetime. Ugyldige eller ikke tillatte verdier returnerer HTTP 422 i stedet for Ä stille inn en standard uten Ä gi beskjed.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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"data": {
"id": 2306,
"pin_protected": false,
"email": "example+alias45@outlook.com",
"domain": "outlook.com",
"provider": "outlook_alias",
"expire_at": "2026-11-19T03:18:07+00:00",
"expires_in_seconds": 3599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:18:07+00:00",
"email_token": "encrypted-email-token"
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
data.id |
integer | Postboks-ID. Genererte ID-er, adresser og token varierer for hver postboks. |
data.pin_protected |
boolean | Om denne postboksen har PIN-beskyttelse. Ingen PIN eller PIN-hash returneres. |
data.email |
string | Generert full postboksadresse. |
data.domain |
string | Domene for den genererte postboksen. |
data.provider |
string | PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias. |
data.expire_at |
string|null | Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks. |
data.expires_in_seconds |
number|null | Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null. |
data.mailbox_state |
string | Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv. |
data.receiving_enabled |
boolean | Om denne postkassen for Ăžyeblikket godtar innkommende meldinger. |
data.message_count |
integer | Kjent total meldingstell; den kan gjenspeile den siste postboksâsynkroniseringen. |
data.unread_message_count |
integer | Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen. |
data.last_message_received_at |
string|null | Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig. |
data.message_count_synced_at |
string|null | Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering. |
data.created_at |
string|null | Postboksens opprettelsestid i ISO-8601-format. |
data.email_token |
string | Ugjennomsiktig kryptert postboksreferanse. Den erstatter ikke Bearer-autentisering, eierskapskontroller eller PIN-autorisering. |
data.pin_grant |
object | Betinget: aktiv PIN-beskyttet postboksoppretting returnerer denne lesetillatelsen; vanlig ubeskyttet opprettelse utelater den. |
data.pin_grant.mailbox_id |
integer | Postkasse-ID som den betingede lesetillatelsen er knyttet til. |
data.pin_grant.unlock_token |
string | Ugjennomsiktig lesetoken for X-Mailbox-Unlock med samme eierlegitimasjon. Hold den privat og i minnet; en lesetillatelse autoriserer ikke sletting. |
data.pin_grant.scope |
string | Omfanget lest for den betingede opprettelsesbevilgningen. |
data.pin_grant.idle_timeout_seconds |
integer | Tillatt inaktiv tid for lesetillatelsen, vanligvis 3600 sekunder. |
data.pin_grant.absolute_timeout_seconds |
integer | Maksimal levetid for lesetillatelsen, vanligvis 86400 sekunder. |
data.pin_grant.expires_at |
string | Gjeldende utlĂžp for lesetillatelse i ISO-8601-format. |
data.pin_grant.absolute_expires_at |
string | Absolutt lesetillatelsesutlĂžp i ISO-8601-format. Sikkerhetsendringer kan tilbakekalle tillatelsen tidligere. |
Meldinger og vedlegg
Hent innkommende innbokser, les fullstendige HTML-/tekstmeldinger, og strĂžm vedlegg.
List postboksmeldinger
Hent tilgjengelige meldingsoppsummeringer og postboksmetadata. Standard innboksâskanninger returnerer en nylig batch pĂ„ opptil 25 meldinger; dette er ikke et paginert fullhistorieâendepunkt. Bruk GET /messages/{messageId} for fullstendige meldingskropper og vedlegg.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
email
|
query | string | pÄkrevd |
Full e-postadresse til den eide postboksen som skal lese meldinger fra. URL-kodér spÞrringsverdien; kod et plustegn som %2B.
|
X-Mailbox-Unlock
|
header | string | valgfri |
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"mailbox": "demo123@example.com",
"email_token": "encrypted-email-token",
"messages": [
{
"is_seen": false,
"subject": "Welcome to Temp Mail",
"from": "Example Sender",
"from_email": "hello@example.org",
"receivedAt": "2026-11-19 02:18:07",
"id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
"otp": null,
"otp_locked": false,
"verification_link": null,
"verification_link_locked": false
}
],
"mailbox_provider": "standard",
"mailbox_state": "active",
"expire_at": "2026-11-20T02:18:07+00:00",
"expires_in_seconds": 86399.75,
"receiving_enabled": true,
"mailbox_limit": {
"limit": 50,
"limit_label": "50",
"active_count": 1,
"paused_count": 0,
"paused_mailboxes": [],
"remaining": 49,
"remaining_label": "49",
"reached": false,
"blocked": false,
"provider": "standard"
},
"message_count": 1,
"unread_message_count": 1,
"last_message_received_at": "2026-11-19T02:18:07+00:00",
"message_count_synced_at": "2026-11-19T02:18:07+00:00"
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
mailbox |
string | Postboksadresse hvis meldinger ble forespurt. |
email_token |
string | Ugjennomsiktig kryptert postboksreferanse; normal autentisering kreves fortsatt. |
mailbox_provider |
string | PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias. |
messages |
array | Meldingsoppsummeringer. En tom innboks returnerer en tom array; hent en enkelt melding for dens innhold og vedlegg. |
expire_at |
string|null | Effektiv utlĂžp som en ISO-8601 tidsstempel, eller null for en ubegrenset postboks. |
expires_in_seconds |
number|null | Ikke-negative sekunder gjenstÄr nÄr beregnet; brÞkdeler av sekunder er mulige. Null betyr ubegrenset, ikke null. |
mailbox_state |
string | Gjeldende postboksstatus: aktiv, pauset, utlĂžpt eller inaktiv. |
receiving_enabled |
boolean | Om denne postkassen for Ăžyeblikket godtar innkommende meldinger. |
message_count |
integer | Kjent total meldingstell; den kan gjenspeile den siste postboksâsynkroniseringen. |
unread_message_count |
integer | Kjent antall uleste meldinger; den kan gjenspeile den siste postkassesynkroniseringen. |
last_message_received_at |
string|null | Sist kjente mottatte meldings tidspunkt i ISO-8601-format, eller null nÄr utilgjengelig. |
message_count_synced_at |
string|null | Siste meldingsteller-synkroniseringstid i ISO-8601-format, eller null fĂžr synkronisering. |
mailbox_limit.limit |
integer | Aktiv postboksgrense for denne leverandĂžren; -1 betyr ubegrenset. |
mailbox_limit.limit_label |
string | Visningsetikett for postbokslimiten. |
mailbox_limit.active_count |
integer | Antall aktive postbokser for denne leverandĂžren. |
mailbox_limit.paused_count |
integer | Antall pausede postbokser for denne leverandĂžren. |
mailbox_limit.paused_mailboxes |
array<string> | Adresser satt pÄ pause av postbokslimitet. |
mailbox_limit.remaining |
integer | GjenvĂŠrende aktive postkasseplasser; -1 betyr ubegrenset. Dette er ikke API-forespĂžrselskvote. |
mailbox_limit.remaining_label |
string | Vis etikett for gjenvĂŠrende postkasseplasser. |
mailbox_limit.reached |
boolean | Om den aktive postboksgrensen er nÄdd. |
mailbox_limit.blocked |
boolean | Om den aktive postboksgrensen er null. |
mailbox_limit.provider |
string|null | LeverandĂžr som postboksgrensen gjelder for. |
messages[].id |
string | Ugjennomsiktig meldings-ID brukt av enkeltmeldingsâ, slettingsâ og vedleggâendepunktene. |
messages[].is_seen |
boolean | Om meldingen er merket som lest. |
messages[].subject |
string | Meldingsemne. |
messages[].from |
string | Avsenders visningsnavn eller adresse. |
messages[].from_email |
string | Avsender eâpostadresse. |
messages[].receivedAt |
string | Mottatt tid i applikasjonens tidssone, formatert som YYYY-MM-DD HH:mm:ss. |
messages[].otp |
string|null | Oppdaget engangskode nÄr tilgjengelig og tillatt; ellers null. |
messages[].otp_locked |
boolean | Om en oppdaget engangskode er skjult av funksjonstillatelser. |
messages[].verification_link |
string|null | Oppdaget verifiserings-URL nÄr tilgjengelig og tillatt; ellers null. |
messages[].verification_link_locked |
boolean | Om en oppdaget verifiseringslenke er skjult av funksjonstillatelser. |
messages[].from_name |
string|null | Outlookâsammendragfelt: opprinnelig avsendernavn. Mangler i Standardâ og Gmailâsammendrag. |
messages[].snippet |
string|null | Outlook-sammendragfelt: kort meldingsforhÄndsvisning. |
messages[].received_at |
string|null | Outlook-sammendragfelt: ISO-8601 mottatt tid, nÄr kjent. |
messages[].has_attachments |
boolean | Outlookâsammendragfelt: om vedleggsmetadata finnes. Nedlastingsâtilgjengelighet sjekkes separat. |
Hent enkeltmelding
Hent en eiet melding ved dens ugjennomsiktige meldings-ID. Returnerer kroppsformater og vedleggsmetadata. Kropps feltene avhenger av meldingsformatet; Outlook legger til leverandĂžrspesifikke felter som er oppfĂžrt nedenfor.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
messageId
|
path | string | pÄkrevd |
Unik meldings-ID returnert i meldingslisten.
|
X-Mailbox-Unlock
|
header | string | valgfri |
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"data": {
"is_seen": true,
"subject": "Welcome to Temp Mail",
"from": "Example Sender",
"from_email": "hello@example.org",
"to": "demo123@example.com",
"mailbox_provider": "standard",
"receivedAt": "2026-11-19 02:18:07",
"id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
"html": true,
"html_content": "<p>Hello from the inbox.</p>",
"text_content": "<pre>Hello from the inbox.</pre>",
"content": "<p>Hello from the inbox.</p>",
"attachments": [
{
"name": "file.txt",
"extension": "txt",
"size": 91,
"url": "https://v1.tempmailg.com/api/messages/ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1/attachments/file.txt"
}
]
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
data.id |
string | Ugjennomsiktig meldings-ID. |
data.is_seen |
boolean | Meldingslesestatus. Ă
lese kan merke den som sett; bufrede data kan gjenspeile en tidligere tilstand. |
data.subject |
string | Meldingsemne. |
data.from |
string | Avsenders visningsnavn eller adresse. |
data.from_email |
string | Avsender eâpostadresse. |
data.to |
string | Mottakers e-postadresse. |
data.mailbox_provider |
string | PostkasseleverandĂžr: standard, gmail_alias eller outlook_alias. |
data.receivedAt |
string | Mottatt tid i applikasjonens tidssone, formatert som YYYY-MM-DD HH:mm:ss. |
data.html |
boolean | Om meldingen har en HTML-body. |
data.html_content |
string | HTML-body nÄr den er tilstede. Standardmeldinger uten HTML kan utelate dette feltet. Behandle meldingsinnhold som upÄlitelig. |
data.text_content |
string | Tekstkropp nÄr tilstede; Standardmeldinger kan inneholde escapet tekst i et pre-element eller utelate dette feltet. |
data.content |
string | Foretrukket innhold for visning, vanligvis HTML nÄr tilgjengelig. |
data.attachments |
array | Vedleggsmetadata, eller en tom matrise. Nedlastinger krever normal autentisering og gjeldende PIN-autorisering. |
data.attachments[].name |
string | Filnavn som skal URLâkodes som ett enkelt stiâsegment ved nedlasting. |
data.attachments[].size |
integer | VedleggsstĂžrrelse i byte. |
data.attachments[].url |
string | Autentisert bruker-API-nedlastings-URL lagt til vedlegg med et filnavn. En URL garanterer ikke at den lokale filen er tilgjengelig. |
data.attachments[].extension |
string | Standard/Gmail-metadatafelt: filtype nÄr den er oppgitt. |
data.attachments[].id |
string | Outlook-metadatafelt: leverandĂžrvedlegg-ID. |
data.attachments[].content_type |
string | Outlook-metadatafelt: MIME innholdstype. |
data.from_name |
string|null | Outlook-detaljfelt: opprinnelig avsendernavn. |
data.to_email |
string|null | Outlook-detaljfelt: original mottakeradresse. |
data.received_at |
string|null | Outlook-detaljfelt: ISO-8601 mottatt tid. |
data.has_html |
boolean | Outlook-detaljfelt: om en HTML-body finnes. |
Slett melding
Slett en enkelt eid melding.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
messageId
|
path | string | pÄkrevd |
Unik meldings-ID-streng for permanent sletting.
|
X-Mailbox-Unlock
|
header | string | valgfri |
Header, kun beskyttede postbokser: bruk den engangsâdeleteâunlock_token. FĂžrst POST pin, scope=delete og action/target_id som returneres av 423âresponsen til PINâunlockâURLen. Et lesetoken kan ikke slette. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | valgfri |
PÄkrevd for PIN-beskyttet opprettelse eller sletting: en stabil nÞkkel pÄ 16 til 128 tegn. Gjenta den identiske forespÞrselen med samme nÞkkel for Ä unngÄ duplisert arbeid.
|
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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": true,
"message": "Message was deleted successfully."
}
| Felt | Type | Beskrivelse |
|---|---|---|
status |
boolean | Om operasjonen lyktes. |
message |
string | Resultat av slettingen. En manglende ressurs returnerer HTTP 404. |
Last ned vedlegg
Last ned en vedlegg fra en eid melding.
| Parameter | Sted | Type | Status | Beskrivelse |
|---|---|---|---|---|
messageId
|
path | string | pÄkrevd |
ID for meldingen som inneholder filen.
|
filename
|
path | string | pÄkrevd |
Filnavn og filtype pÄ vedlegget som skal lastes ned.
|
X-Mailbox-Unlock
|
header | string | valgfri |
Header, kun beskyttede postbokser: bruk en read unlock_token. FĂžrst POST pin og scope=read til PIN unlock URL. Behold din vanlige Bearer-autentisering. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
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 | Vellykket respons laster ned det forespurte filnavnet. |
body |
binary | Filbytes ved suksess, ikke JSON. Feil returnerer JSON med en ikke-2xx status. |
Ratebegrensninger og kvoter
OvervÄk sanntidsforespÞrselsbudsjetter, hastighetsbegrensninger og kontokvoter uten Ä bruke kreditter.
Ratebegrensning og kvote
Sjekk din nÄvÊrende hastighetsgrense og kvotestatus uten Ä bruke noen API-bruk. Dette endepunktet er kvotefritt og trekker ikke fra mÄnedlige API-kreditter (misbrukbeskyttelsesgrense: 60 forespÞrsler/min).
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'
Illustrativ respons ved bruk av syntetiske data. ID-er, adresser, token, tidsstempler, planbegrensninger og teller varierer. Eksempellivstider overstyrer ikke standardplanen din. Responsfeltnes beskrivelser identifiserer nullable og leverandĂžrspesifikke felter.
Eksempel pÄ svar
200 OK • JSON{
"status": "success",
"data": {
"limit": 60,
"remaining": 45,
"reset": 32,
"plan": "premium",
"monthly_limit": 50000,
"monthly_remaining": 48210,
"purchased_credits": 5000,
"quota": {
"enabled": true,
"user_api_status": true,
"plan_name": "Premium Plan",
"period": "2026-10",
"base_limit": 50000,
"extra_requests": 0,
"monthly_limit": 50000,
"monthly_remaining": 48210,
"used": 1790,
"purchased_credits": 5000,
"bonus_credits": 1000,
"direct_purchased_credits": 4000,
"remaining": 53210,
"unlimited": false,
"usage_percent": 3,
"reset_at": "2026-11-01T00:00:00+00:00"
}
}
}
| Felt | Type | Beskrivelse |
|---|---|---|
data.limit |
integer|string | Kontoens forespÞrsler-per-minutt-grense. Strengen unlimited betegner et ubegrenset minuttbudsjett; dette er uavhengig av mÄnedlig kvote. |
data.remaining |
integer|string | GjenvĂŠrende kontoâminuttbudsjettplasser, eller strengen unlimited. En positiv verdi betyr ikke at APIâkreditter gjenstĂ„r. |
data.reset |
integer | Sekunder for kontots minuttvindu, ikke den mÄnedlige kvote-tilbakestillingen. Deaktiverte eller ubegrensede minuttbudsjetter kan beholde en nominell verdi pÄ 60 sekunder; dette garanterer ikke tilgang etter venting. |
data.plan |
string | NÄvÊrende planetikett. Det lesbare planenavnet er gitt separat i data.quota.plan_name. |
data.quota.enabled |
boolean | Om global og plan/kreditt API-tilgang er aktivert. Dette indikerer ikke gjenvĂŠrende kapasitet eller erstatter bruker-API-bryteren. |
data.quota.user_api_status |
boolean | Om brukeren har aktivert sin User API-bryter. Operasjoner krever denne bryteren samt aktivert tilgang og tilgjengelig kapasitet. |
data.quota.plan_name |
string | Lesbart navn pÄ gjeldende plan. |
data.quota.period |
string | KalendermÄnedens bruksperiode i formatet YYYY-MM, med applikasjonens tidssone; ikke nÞdvendigvis abonnementets faktureringsperiode. |
data.quota.base_limit |
integer | Basis mÄnedlig plan tillatelse. En verdi pÄ -1 betyr ubegrenset. |
data.quota.extra_requests |
integer | Ekstra mÄnedlig tillatelse gitt for den nÄvÊrende bruksperioden; separat fra kjÞpte kreditter. |
data.quota.monthly_limit |
integer | Grunnleggende kvote pluss ekstra forespÞrsler for innevÊrende periode. En verdi pÄ -1 betyr ubegrenset. KjÞpte kreditter er ikke inkludert. |
data.quota.monthly_remaining |
integer|null | GjenvÊrende endelige mÄnedlige kvote, eller null nÄr den mÄnedlige kvoten er ubegrenset. Null mÄ ikke tolkes som null. |
data.quota.used |
integer | Vellykkede, tellede APIâoperasjoner i den nĂ„vĂŠrende bruksperioden, inkludert operasjoner som bruker kreditter. Statuskontroller Ăžker ikke denne verdien. |
data.quota.purchased_credits |
integer | Gjeldende kredittsaldo, inkludert bonuskreditter for aktiv plan. Bonuskreditter mÄ ikke legges til denne saldoen en gang til. |
data.quota.bonus_credits |
integer | Aktiv planbonusdel av kredittbalansen; en oppdeling av purchased_credits, ikke ekstra kapasitet. |
data.quota.direct_purchased_credits |
integer | Kredittsaldo ekskludert den aktive plan-bonusdelen. Denne verdien pluss bonus_credits er lik purchased_credits. |
data.quota.remaining |
integer|null | MÄnedlig gjenvÊrende kvote pluss nÄvÊrende kredittsaldo, uten Ä telle bonuser dobbelt. Null betyr ubegrenset mÄnedlig kvote. Individuelle funksjonstillatelser og andre forespÞrselsgrenser gjelder fortsatt. |
data.quota.unlimited |
boolean | Om mÄnedlig kvote er ubegrenset. Dette gjÞr ikke kontoens minuttsbudsjett eller andre funksjonsgrenser ubegrenset. |
data.quota.usage_percent |
integer | Dashboard-kompatibel avrundet prosent fra 0 til 100: brukt delt pÄ brukt pluss resterende, multiplisert med 100. Den inkluderer tilgjengelig kredittkapasitet, sÄ pÄfylling kan senke prosentandelen. Den er 0 for ubegrenset kvote eller et nullstÞrrelses-pool; den er ikke prosentandelen for minuttraten eller en tilgangsbeslutning. |
data.quota.reset_at |
string | ISO-8601-tidsstempel med tidssoneforskyvning for neste kalendermÄnedens kvote-tilbakestilling. Dette er ikke abonnementets utlÞpsdato, og den mÄnedlige tilbakestillingen fyller ikke pÄ kjÞpte kreditter. |
status |
string | Den bokstavelige suksessen for dette status-endepunktet. Andre vellykkede postboks-endepunkter bruker den boolske true. |
data.monthly_limit |
integer | Kompatibilitetsalias for det tilsvarende data.quota-feltet; ikke legg det til igjen nÄr du beregner saldoer. |
data.monthly_remaining |
integer|null | Kompatibilitetsalias for det tilsvarende data.quota-feltet; ikke legg det til igjen nÄr du beregner saldoer. |
data.purchased_credits |
integer | Kompatibilitetsalias for det tilsvarende data.quota-feltet; ikke legg det til igjen nÄr du beregner saldoer. |
E-postkasse-webhooks (i sanntid)
I stedet for Ă„ gjenta poll av REST-API (GET /messages) for Ă„ sjekke etter innkommende e-post, konfigurerer du Webhooks for Ă„ sende nye meldinger til serveren din eller automatiseringsarbeidsflyt i sanntid.
StĂžttede Webhook-hendelser
Hver webhook kan abonnere pÄ en eller flere hendelsestypene. Din endepunkt mottar en hendelsesvarsel nÄr en av disse utlÞsere aktiveres.
Sendt i sanntid hver gang en ny melding nÄr den valgte postboksen.
Sendes nÄr den midlertidige postboksen utlÞper og webhook-behandlingen er satt pÄ pause.
Sendes nÄr en utlÞpt postboks blir aktiv igjen under planregler.
Sendt rett fĂžr webhooken og dens postboks blir slettet.
SpĂžrringshoder & HMAC Signaturverifisering
Hvert webhook-levering inneholder spesielle sikkerhetshoder. Bruk X-TempMailg-Signature-hodet for Ä verifisere at innkommende forespÞrsler ble sendt pÄ en Êrlig mÄte av TempMailg og ikke har blitt endret.
| Overskriftstittel | Eksempelverdi | Beskrivelse |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Standardidentifikator for webhook-leveringsarbeideren. |
X-TempMailg-Event |
email.received | Hendelsestypen som utlĂžste denne leveransen. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Unik UUID tilordnet dette leveringsforsĂžket. |
X-TempMailg-Timestamp |
1725192000 | Unix-epoketidsstempel som indikerer nÄr forespÞrselen ble initiert. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | HMAC-SHA256-signatur beregnet fra {timestamp}.{raw_body} ved hjelp av din hemmelighet. |
X-TempMailg-Test |
false | Sant nÄr sendt av "Send Test Ping"-funksjonen i dashbordet ditt. |
Signaturen beregnes ved hjelp av HMAC med SHA256 over denne streng:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Eksempel pÄ Hendelsesbetegnelse (email.received)
Levert som `application/json` i kroppen av HTTP POST-forespĂžrselen.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:18:07+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:18:07+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Ä mottakerimplementering
Velg sprĂ„ket ditt for Ă„ se hvordan du mottar webhooks og verifiserer HMACâsignaturer pĂ„ en sikker mĂ„te.
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]);
StĂžttede plattformer og automatiseringsintegrasjoner
TempMailg Webhooks fungerer umiddelbart med standard HTTPS-endepunkter og ledende no-code/automatiseringsplattformer:
Vanlige feil og feilsĂžking
Dette er de vanligste responskodene du kan se mens du integrerer bruker-API-en.
Ugyldig, manglende eller tilbakekalt Bearer-token.
Eierskap, funksjonstillatelser, domenetilgang eller vedleggsstĂžrrelse hindret operasjonen. Sjekk responskoden og meldingen.
Ressursen ble ikke funnet pÄ den tillatte verts- eller tilhÞrer ikke brukeren.
OperasjonsnÞkkelen ble brukt pÄ nytt med forskjellige detaljer, en annen operasjon er pÄ vent, eller postboksens sikkerhet ble endret. UndersÞk koden fÞr du prÞver igjen.
Postboksen er utlĂžpt eller inaktiv.
Ugyldige parametere, en ikke tillatt levetid, utilgjengelig aliaskapasitet, ugyldig PIN-oppsett eller en manglende/ugyldig Idempotency-Key hindret operasjonen.
En beskyttet postboks trenger et gyldig avgrenset X-Mailbox-Unlock-token. Bruk handlingen og target_id fra svaret for sletting. LÄse- eller gjenopprettingskrav mÄ lÞses fÞr du prÞver igjen.
En forespĂžrselsgrense, deaktivert plan, oppbrukt kvote eller nedkjĂžling hindret operasjonen. Sjekk Ă„rsaken og tilgjengelige budsjettâoverskrifter. Retry-After er valgfritt.
Serveren kunne ikke fullfĂžre operasjonen. For beskyttet opprettelse eller sletting, behold samme forespĂžrsel og Idempotency-Key ved gjentakelse.
Beskyttelseslagring eller koordinering kunne ikke verifiseres. PrĂžv igjen etter den angitte forsinkelsen. Dette svaret er ikke en mislykket betaling.
Rask sjekklister
- 401 Unauthorized - Bearer-token mangler, er feil, er tilbaktatt eller er kopiert feil.
- 403 Forbidden - Gjeldende plan har ikke bruker-API-tilgang for Ăžyeblikket.
- 404 Not Found - Ressurs ikke funnet eller ugyldig parameter
- 410 Gone / Expired - Postkassen er utlĂžpt eller er ikke lenger aktiv.
- 429 Rate Limited - Sjekk responsÄrsaken og budsjett-headerne. Retry-After gjelder kun for tidsbegrensninger; oppbrukte kreditter eller deaktivert tilgang kan kreve en kontendring.
Anbefalt neste steg
Hvis du er logget inn, Äpne API-hÄndtering fÞrst og bekreft din nÞkkel, kvote, plan-tilgangsstatus og den eksakte bruker-API-basen-URL fÞr du feilsÞker din eksterne app.