Snel instellijst
- Open uw dashboard API-beheerpagina en maak uw persoonlijke API-sleutel.
- Kopieer de exacte gebruikers-API-basis-URL die daar wordt weergegeven, bijvoorbeeld https://v1.tempmailg.com/api.
- Stuur elke aanvraag naar die API-host met Authorization: Bearer YOUR_USER_API_KEY en Accept: application/json.
- Volg je maandelijkse aanvraagquotum vanaf dezelfde dashboardpagina en via quotakoppen wanneer beschikbaar in gebruikers-API-reacties. Alleen succesvolle 2xx-verzoeken tellen mee voor het quotum.
Verificatieflow
- Genereer uw persoonlijke API-sleutel vanaf de dashboard API Management-pagina.
- Stuur de sleutel als een Bearer-token in elke aanvraag.
- Gebruik de speciale User API-basis-URL zoals weergegeven op uw API Management-pagina.
- Genereer de sleutel opnieuw wanneer u de oude wilt intrekken en direct een nieuwe sleutel wilt gaan gebruiken.
Vereiste kopteksten
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Rate Limiet & Quotum Headers
Rate-limit headers beschrijven het aangegeven aanvraagbudget. Quota-headers worden opgenomen wanneer quota-informatie beschikbaar is; minute-limit afwijzingen berekenen uw volledige maandelijkse quota niet.
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— Maximum aantal verzoeken per minuut (RPM) voor uw plan.X-RateLimit-Remaining— Resterende RPM‑verzoeken in het huidige minuutvenster.X-RateLimit-Reset— Unix-tijdstempel wanneer het huidige minuut-snelheidslimietvenster wordt gereset.X-Quota-Limit— Totale maandelijkse en gekochte kredietcapaciteit voor uw account.X-Quota-Remaining— Resterende beschikbare API-verzoeken in de huidige maand.X-Quota-Used— Totaal aantal API-verzoeken verbruikt tijdens de huidige factureringsperiode.X-Quota-Reset— ISO-8601 tijdstempel wanneer je maandelijkse quotum wordt gereset.X-RateLimit-Scope— Het budget beschreven door de headers: account, ip, status_endpoint, of mailbox.X-Mailbox-RateLimit-*— Aparte mailbox aanmaak/bijwerkbudget. Succesvolle mailboxreacties behouden account RPM in X-RateLimit-*; een alleen-mailboxafwijzing gebruikt de mailboxscope en zijn eigen retry‑venster.Retry-After— Seconden tot een tijdige herpoging geschikt is. Een uitgeschakeld abonnement of uitgeputte quota kan in plaats daarvan een accountwijziging vereisen, dus deze header is niet altijd aanwezig.503 protection_unavailable— API-beschermingsopslag of -coördinatie is tijdelijk niet beschikbaar. Probeer later opnieuw; dit is geen betalingsfout of een creditdebet.
Mailboxbeheer
Haal toegestane domeinen op, maak of wissel mailboxen, kies toegestane levensduur, en verwijder eigen adressen.
Lijst van toegestane domeinen
Lijst beschikbare domeinen voor het maken van tijdelijke e‑mailadressen. Filter op type om alleen gratis, premium of aangepaste domeinen te zien die door uw abonnement worden ondersteund.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
type
|
query | string | optioneel |
Domeinniveau-filter. Bij weglaten wordt alles gebruikt wanneer premium-domeintoegang is ingeschakeld, anders gratis. Herkende waarden: free, basic, pro, premium, custom, ultimate, all
Standaard:
Accountafhankelijk
|
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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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
}
]
}
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
data.requested_type |
string | Toegepast domeinfilter. |
data.plan |
string | Huidige planlabel. |
data.plan_name |
string | Leesbare naam van het huidige plan. |
data.allowed_types |
array<string> | Domeinfilters beschikbaar voor dit account. Een herkend filter kan nog steeds verboden zijn voor uw plan. |
data.domains |
array | Selecteerbare domeinen na filtering; een lege array is geldig. |
data.domains[].domain |
string | Selecteerbare domeinnaam. |
data.domains[].type |
string | Leesbaar domein tier-label. |
data.domains[].custom |
boolean | Of dit een aangepast domein is. |
Tijdelijk postvak aanmaken
Maak een eigen tijdelijk postvak. Laat gebruikersnaam en domein weg voor willekeurige generatie, of lever een toegestane aangepaste gebruikersnaam en een toegestaan domein. De provider-parameter kan Gmail of Outlook aliasgeneratie selecteren.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
username
|
body | string | optioneel |
Optionele aangepaste gebruikersnaam: 2 tot 64 ASCII-letters, cijfers, punten, onderstrepingen of koppeltekens. Vereist planpermissie; custom_username wordt ook geaccepteerd.
Standaard:
Willekeurig gegenereerd
|
domain
|
body | string | optioneel |
Een van de toegestane domeinen die worden geretourneerd door GET /domains. Weglaten kiest een willekeurig toegestaan domein.
Standaard:
Willekeurig toegestaan domein
|
lifetime
|
body | string | optioneel |
toegestane waarden:
10m — 10 Minuten
1h — 1 Uur
2h — 2 uur
1d — 1 dag
1w — 1 Week
1m — 30 dagen
3m — 90 dagen
6m — 180 dagen
1y — 365 dagen
unlimited — Onbeperkt
Standaard:
Standaard levensduur van het plan
|
provider
|
body | string | optioneel |
Postvakprovider: standard, gmail_alias, of outlook_alias.
Standaard:
standard
|
pin_enabled
|
body | boolean | optioneel |
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard:
false
|
pin
|
body | string | optioneel |
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
|
pin_confirmation
|
body | string | optioneel |
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
|
Idempotency-Key
|
header | string | optioneel |
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
|
username (aangepaste gebruikersnaam indien toegestaan door het abonnement), domain (toegestane domein, bijv. example.com), lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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:09+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:09+00:00",
"email_token": "encrypted-email-token"
}
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
data.id |
integer | Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox. |
data.pin_protected |
boolean | Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd. |
data.email |
string | Volledig mailboxadres gegenereerd. |
data.domain |
string | Domein van de gegenereerde mailbox. |
data.provider |
string | Postvakprovider: standard, gmail_alias, of outlook_alias. |
data.expire_at |
string|null | Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox. |
data.expires_in_seconds |
number|null | Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul. |
data.mailbox_state |
string | Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief. |
data.receiving_enabled |
boolean | Of deze mailbox momenteel inkomende berichten accepteert. |
data.message_count |
integer | Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen. |
data.unread_message_count |
integer | Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven. |
data.last_message_received_at |
string|null | Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar. |
data.message_count_synced_at |
string|null | Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie. |
data.created_at |
string|null | Mailboxcreatietijd in ISO-8601-formaat. |
data.email_token |
string | Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie. |
data.pin_grant |
object | Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld. |
data.pin_grant.unlock_token |
string | Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering. |
data.pin_grant.scope |
string | De scope lezen voor de voorwaardelijke creatietoekenning. |
data.pin_grant.idle_timeout_seconds |
integer | Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximum levensduur van de leesmachtiging, normaal 86400 seconden. |
data.pin_grant.expires_at |
string | Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat. |
data.pin_grant.absolute_expires_at |
string | Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken. |
Bijwerken / Wissel mailbox
Maak een mailbox aan of selecteer er een op de nieuwe gebruikersnaam en domein nadat u het eigendom van de huidige mailbox heeft geverifieerd. Dit hernoemt de oude mailbox niet en wijzigt de levensduur ervan niet op dezelfde plaats. Wanneer de bestemming verschilt, blijft de oude mailbox in de geschiedenis en kan deze worden gepauzeerd door limieten voor actieve mailboxen. Het hergebruiken van uw eigen actieve bestemming past de gevraagde levensduur of de standaardinstelling van het abonnement opnieuw toe.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
email
|
path | string | verplicht |
Huidig volledig e-mailadres van de eigendom mailbox om te wisselen. URL-encode elk padsegment; codeer een plusteken als %2B.
|
username
|
path | string | verplicht |
Nieuwe gewenste gebruikersnaam: 2 tot 64 alfanumerieke tekens; onderhevig aan toestemming voor aangepaste gebruikersnaam.
|
domain
|
path | string | verplicht |
Nieuwe toegestane domeinnaam.
|
lifetime
|
body | string | optioneel |
toegestane waarden:
10m — 10 Minuten
1h — 1 Uur
2h — 2 uur
1d — 1 dag
1w — 1 Week
1m — 30 dagen
3m — 90 dagen
6m — 180 dagen
1y — 365 dagen
unlimited — Onbeperkt
Standaard:
Standaard levensduur van het plan
|
pin_enabled
|
body | boolean | optioneel |
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard:
false
|
pin
|
body | string | optioneel |
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
|
pin_confirmation
|
body | string | optioneel |
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
|
Idempotency-Key
|
header | string | optioneel |
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
|
X-Mailbox-Unlock
|
header | string | optioneel |
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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:09+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:09+00:00",
"email_token": "encrypted-email-token"
}
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
data.id |
integer | Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox. |
data.pin_protected |
boolean | Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd. |
data.email |
string | Volledig mailboxadres gegenereerd. |
data.domain |
string | Domein van de gegenereerde mailbox. |
data.provider |
string | Postvakprovider: standard, gmail_alias, of outlook_alias. |
data.expire_at |
string|null | Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox. |
data.expires_in_seconds |
number|null | Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul. |
data.mailbox_state |
string | Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief. |
data.receiving_enabled |
boolean | Of deze mailbox momenteel inkomende berichten accepteert. |
data.message_count |
integer | Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen. |
data.unread_message_count |
integer | Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven. |
data.last_message_received_at |
string|null | Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar. |
data.message_count_synced_at |
string|null | Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie. |
data.created_at |
string|null | Mailboxcreatietijd in ISO-8601-formaat. |
data.email_token |
string | Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie. |
data.pin_grant |
object | Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld. |
data.pin_grant.unlock_token |
string | Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering. |
data.pin_grant.scope |
string | De scope lezen voor de voorwaardelijke creatietoekenning. |
data.pin_grant.idle_timeout_seconds |
integer | Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximum levensduur van de leesmachtiging, normaal 86400 seconden. |
data.pin_grant.expires_at |
string | Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat. |
data.pin_grant.absolute_expires_at |
string | Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken. |
Mailbox verwijderen
Verwijder een eigendom mailbox en roep de opschoning van berichten en bestanden op. Behouden mailboxrecords kunnen intern zacht worden verwijderd; het adres is niet langer bruikbaar via de API.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
email
|
path | string | verplicht |
Volledig e-mailadres van de mailbox die u bezit om te verwijderen. URL-encode het adres; codeer een plusteken als %2B.
|
X-Mailbox-Unlock
|
header | string | optioneel |
Header, alleen voor beveiligde mailboxen: gebruik de eenmalige delete unlock_token. Eerst POST pin, scope=delete en de action/target_id die wordt geretourneerd door de 423-respons op de PIN unlock URL. Een read token kan niet verwijderen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | optioneel |
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
|
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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
200 OK • JSON{
"status": true,
"message": "Email has been successfully deleted."
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
message |
string | Resultaat van de verwijdering. Een ontbrekende bron geeft HTTP 404 terug. |
Gmail & Outlook-aliasen
Genereer aliasmailboxen met een hoge reputatie voor Gmail en Outlook/Hotmail.
Gmail-alias maken
Maak een nieuwe tijdelijke Gmail-aliasmailbox aan die eigendom is van de geauthenticeerde gebruiker.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
mode
|
body | string | optioneel |
Generatiemodus: auto, dot, plus of plus_dot. Accepteert ook gmail_alias_mode. Als stijlselectie niet is toegestaan, wordt auto gebruikt.
Standaard:
auto
|
username
|
body | string | optioneel |
Optionele aangepaste alias-achtervoegsel: 2 tot 32 ASCII-letters of cijfers, genormaliseerd naar kleine letters; onderhevig aan functiepermissie. Accepteert ook custom_username of alias_username.
Standaard:
Automatisch gegenereerd
|
domain
|
body | string | optioneel |
Gebruik willekeurig, gmail.com of googlemail.com; alias_domain wordt ook geaccepteerd. Weglaten of onbeschikbare domein-selectie toestemming gebruikt willekeurig.
Standaard:
random
|
lifetime
|
body | string | optioneel |
toegestane waarden:
10m — 10 Minuten
1h — 1 Uur
2h — 2 uur
1d — 1 dag
1w — 1 Week
1m — 30 dagen
3m — 90 dagen
6m — 180 dagen
1y — 365 dagen
unlimited — Onbeperkt
Standaard:
Standaard levensduur van het plan
|
pin_enabled
|
body | boolean | optioneel |
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard:
false
|
pin
|
body | string | optioneel |
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
|
pin_confirmation
|
body | string | optioneel |
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
|
Idempotency-Key
|
header | string | optioneel |
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
|
mode (auto, dot, plus, plus_dot), username (aangepaste alias gebruikersnaam), domain (bijv. gmail.com, googlemail.com), lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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:09+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:09+00:00",
"email_token": "encrypted-email-token"
}
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
data.id |
integer | Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox. |
data.pin_protected |
boolean | Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd. |
data.email |
string | Volledig mailboxadres gegenereerd. |
data.domain |
string | Domein van de gegenereerde mailbox. |
data.provider |
string | Postvakprovider: standard, gmail_alias, of outlook_alias. |
data.expire_at |
string|null | Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox. |
data.expires_in_seconds |
number|null | Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul. |
data.mailbox_state |
string | Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief. |
data.receiving_enabled |
boolean | Of deze mailbox momenteel inkomende berichten accepteert. |
data.message_count |
integer | Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen. |
data.unread_message_count |
integer | Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven. |
data.last_message_received_at |
string|null | Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar. |
data.message_count_synced_at |
string|null | Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie. |
data.created_at |
string|null | Mailboxcreatietijd in ISO-8601-formaat. |
data.email_token |
string | Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie. |
data.pin_grant |
object | Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld. |
data.pin_grant.unlock_token |
string | Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering. |
data.pin_grant.scope |
string | De scope lezen voor de voorwaardelijke creatietoekenning. |
data.pin_grant.idle_timeout_seconds |
integer | Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximum levensduur van de leesmachtiging, normaal 86400 seconden. |
data.pin_grant.expires_at |
string | Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat. |
data.pin_grant.absolute_expires_at |
string | Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken. |
Outlook Aliasdomeinen
Haal actieve Outlook / Hotmail aliasdomeinen op die beschikbaar zijn voor mailboxgeneratie.
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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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
}
]
}
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
data.domains |
array | Actieve Outlook/Hotmail-domeinen; een lege array is geldig. |
data.domains[].domain |
string | Beschikbare domeinnaam. |
data.domains[].type |
string | Leesbaar providerlabel. |
data.domains[].selectable |
boolean | Of uw account deze domein expliciet mag kiezen. |
data.domains[].locked |
boolean | Of expliciete domeinselectie is vergrendeld voor uw account. |
data.domains[].disabled_reason |
string|null | Reden dat domeinselectie vergrendeld is, of null wanneer selecteerbaar. |
Outlook-alias maken
Maak een nieuw Outlook / Hotmail-alias tijdelijk mailbox die eigendom is van de geauthenticeerde gebruiker.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
domain
|
body | string | optioneel |
Gebruik willekeurig of een domein van GET /outlook-alias/domains; outlook_alias_domain wordt ook geaccepteerd. Zonder selectierechten wordt willekeurig gebruikt.
Standaard:
Willekeurige beschikbare domein
|
username
|
body | string | optioneel |
Optionele aangepaste alias-achtervoegsel: 2 tot 32 ASCII-letters of cijfers, genormaliseerd naar kleine letters; onderhevig aan functiepermissie. Accepteert ook custom_username of alias_username.
Standaard:
Automatisch gegenereerd
|
lifetime
|
body | string | optioneel |
toegestane waarden:
10m — 10 Minuten
1h — 1 Uur
2h — 2 uur
1d — 1 dag
1w — 1 Week
1m — 30 dagen
3m — 90 dagen
6m — 180 dagen
1y — 365 dagen
unlimited — Onbeperkt
Standaard:
Standaard levensduur van het plan
|
pin_enabled
|
body | boolean | optioneel |
Optionele PIN-beveiliging voor de nieuwe mailbox, wanneer toegestaan door uw abonnement. Het verandert de PIN van een bestaande mailbox niet.
Standaard:
false
|
pin
|
body | string | optioneel |
Vereist wanneer pin_enabled true is: een pincode van 6 tot 8 cijfers, verzonden als een string om voorloopnullen te behouden.
|
pin_confirmation
|
body | string | optioneel |
Vereist wanneer pin_enabled true is. Moet exact overeenkomen met pin.
|
Idempotency-Key
|
header | string | optioneel |
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
|
domain (bijv. outlook.com, hotmail.com), username (aangepaste alias gebruikersnaam), lifetime (toegestane waarden: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Laat de levensduur weg, of laat deze leeg, om de Standaard e-maillevensduur te gebruiken die is geconfigureerd voor je huidige maandelijkse/jaarlijkse abonnement. Stuur een toegestane levensduur, zoals 1u, om die standaard te overschrijven. Onbeperkt wordt alleen gebruikt wanneer dit is geconfigureerd als de standaard voor het abonnement of expliciet wordt aangevraagd en toegestaan. De body-parameters mailbox_lifetime en email_lifetime worden ook geaccepteerd; de eerste niet-lege waarde wint in deze volgorde: lifetime, mailbox_lifetime, email_lifetime. Ongeldige of niet-toegestane waarden geven HTTP 422 terug in plaats van stilletjes een standaard te selecteren.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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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:09+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:09+00:00",
"email_token": "encrypted-email-token"
}
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
data.id |
integer | Mailbox-ID. Gegenereerde ID's, adressen en tokens verschillen per mailbox. |
data.pin_protected |
boolean | Of deze mailbox PIN-beveiliging heeft. Er wordt geen PIN of PIN‑hash geretourneerd. |
data.email |
string | Volledig mailboxadres gegenereerd. |
data.domain |
string | Domein van de gegenereerde mailbox. |
data.provider |
string | Postvakprovider: standard, gmail_alias, of outlook_alias. |
data.expire_at |
string|null | Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox. |
data.expires_in_seconds |
number|null | Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul. |
data.mailbox_state |
string | Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief. |
data.receiving_enabled |
boolean | Of deze mailbox momenteel inkomende berichten accepteert. |
data.message_count |
integer | Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen. |
data.unread_message_count |
integer | Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven. |
data.last_message_received_at |
string|null | Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar. |
data.message_count_synced_at |
string|null | Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie. |
data.created_at |
string|null | Mailboxcreatietijd in ISO-8601-formaat. |
data.email_token |
string | Ondoorzichtige versleutelde mailboxreferentie. Het vervangt geen Bearer-authenticatie, eigendomscontroles of PIN-autorisatie. |
data.pin_grant |
object | Voorwaardelijk: actieve PIN-beveiligde mailboxcreatie retourneert deze leesmachtiging; gewone onbeveiligde creatie laat het weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID waaraan de voorwaardelijke leesmachtiging is gekoppeld. |
data.pin_grant.unlock_token |
string | Ondoorzichtig leestoegangstoken voor X-Mailbox-Unlock met dezelfde eigenaarreferentie. Houd het privé en in het geheugen; een leestoegang verleent geen toestemming tot verwijdering. |
data.pin_grant.scope |
string | De scope lezen voor de voorwaardelijke creatietoekenning. |
data.pin_grant.idle_timeout_seconds |
integer | Toegestane idle-tijd voor de leesmachtiging, normaal 3600 seconden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximum levensduur van de leesmachtiging, normaal 86400 seconden. |
data.pin_grant.expires_at |
string | Huidige vervaldatum van de leesmachtiging in ISO-8601-formaat. |
data.pin_grant.absolute_expires_at |
string | Absolute lees-toestemming vervaldatum in ISO-8601-formaat. Beveiligingswijzigingen kunnen de toestemming eerder intrekken. |
Berichten & Bijlagen
Ophalen van binnenkomende inboxen, volledige HTML-/tekstberichten lezen en bijlagen streamen.
Mailboxberichten weergeven
Haal beschikbare berichtsamenvattingen en mailboxmetadata op. Standaard inbox-scans geven een recente batch van maximaal 25 berichten terug; dit is geen gepagineerd endpoint voor volledige geschiedenis. Gebruik GET /messages/{messageId} voor volledige inhoud en bijlagen.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
email
|
query | string | verplicht |
Volledig e-mailadres van de eigen mailbox om berichten van te lezen. URL-encode de querywaarde; codeer een plusteken als %2B.
|
X-Mailbox-Unlock
|
header | string | optioneel |
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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:09",
"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:09+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:09+00:00",
"message_count_synced_at": "2026-11-19T02:18:09+00:00"
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
mailbox |
string | Postvakadres waarvan de berichten werden opgevraagd. |
email_token |
string | Ondoorzichtige versleutelde mailboxreferentie; normale authenticatie is nog steeds vereist. |
mailbox_provider |
string | Postvakprovider: standard, gmail_alias, of outlook_alias. |
messages |
array | Berichtoverzichten. Een lege inbox geeft een lege array terug; haal een enkel bericht op voor de inhoud en bijlagen. |
expire_at |
string|null | Effectieve vervaldatum als een ISO-8601 tijdstempel, of null voor een onbeperkte mailbox. |
expires_in_seconds |
number|null | Niet-negatieve seconden die overblijven bij berekening; fracties van seconden zijn mogelijk. Null betekent onbeperkt, niet nul. |
mailbox_state |
string | Huidige mailboxstatus: actief, gepauzeerd, verlopen of inactief. |
receiving_enabled |
boolean | Of deze mailbox momenteel inkomende berichten accepteert. |
message_count |
integer | Bekende totale berichtenaantal; het kan de laatste mailbox-synchronisatie weerspiegelen. |
unread_message_count |
integer | Bekend aantal ongelezen berichten; het kan de laatste mailbox-synchronisatie weergeven. |
last_message_received_at |
string|null | Laatst bekende ontvangen-berichttijd in ISO-8601-formaat, of null wanneer niet beschikbaar. |
message_count_synced_at |
string|null | Laatste berichtentelling-synchronisatietijd in ISO-8601-formaat, of null vóór synchronisatie. |
mailbox_limit.limit |
integer | Actieve mailboxlimiet voor deze provider; -1 betekent onbeperkt. |
mailbox_limit.limit_label |
string | Weergavelabel voor de postvaklimiet. |
mailbox_limit.active_count |
integer | Aantal actieve mailboxen voor deze provider. |
mailbox_limit.paused_count |
integer | Aantal gepauzeerde mailboxen voor deze provider. |
mailbox_limit.paused_mailboxes |
array<string> | Adressen gepauzeerd door de mailboxlimiet. |
mailbox_limit.remaining |
integer | Resterende actieve mailbox slots; -1 betekent onbeperkt. Dit is geen API-verzoekquotum. |
mailbox_limit.remaining_label |
string | Weergavelabel voor resterende mailboxplaatsen. |
mailbox_limit.reached |
boolean | Of de limiet voor actieve mailboxen is bereikt. |
mailbox_limit.blocked |
boolean | Of de actieve postvaklimiet nul is. |
mailbox_limit.provider |
string|null | Provider waarop de mailboxlimiet van toepassing is. |
messages[].id |
string | Ondoorzichtige bericht-ID gebruikt door de single-message-, verwijderings- en bijlage‑eindpunten. |
messages[].is_seen |
boolean | Of het bericht als gelezen is gemarkeerd. |
messages[].subject |
string | Berichtonderwerp. |
messages[].from |
string | Weergavenaam of adres van de afzender. |
messages[].from_email |
string | E‑mailadres van afzender. |
messages[].receivedAt |
string | Ontvangsttijd in de tijdzone van de applicatie, geformatteerd als YYYY-MM-DD HH:mm:ss. |
messages[].otp |
string|null | Gedetecteerde eenmalige code wanneer beschikbaar en toegestaan; anders null. |
messages[].otp_locked |
boolean | Of een gedetecteerde eenmalige code verborgen is door functiepermissies. |
messages[].verification_link |
string|null | Gedetecteerde verificatie-URL wanneer beschikbaar en toegestaan; anders null. |
messages[].verification_link_locked |
boolean | Of een gedetecteerde verificatielink verborgen is door functierechten. |
messages[].from_name |
string|null | Outlook-samenvattingsveld: originele afzendernaam. Afwezig in Standaard- en Gmail-samenvattingen. |
messages[].snippet |
string|null | Outlook-samenvattingsveld: korte berichtpreview. |
messages[].received_at |
string|null | Outlook-samenvattingsveld: ISO-8601 ontvangen tijd, indien bekend. |
messages[].has_attachments |
boolean | Outlook-samenvattingsveld: of bijlage-metadata bestaat. Downloadbeschikbaarheid wordt afzonderlijk gecontroleerd. |
Enkel bericht ophalen
Haal een eigen bericht op via zijn ondoorzichtige bericht-ID. Retourneert bodyformaten en bijlage‑metadata. Body‑velden zijn afhankelijk van het berichtformaat; Outlook voegt provider‑specifieke velden toe zoals hieronder vermeld.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
messageId
|
path | string | verplicht |
Unieke bericht-ID geretourneerd in de berichtenlijst.
|
X-Mailbox-Unlock
|
header | string | optioneel |
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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:09",
"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"
}
]
}
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
data.id |
string | Ondoorzichtig bericht-ID. |
data.is_seen |
boolean | Berichtleesstatus. Lezen kan het als gezien markeren; gecachte gegevens kunnen een eerdere status weergeven. |
data.subject |
string | Berichtonderwerp. |
data.from |
string | Weergavenaam of adres van de afzender. |
data.from_email |
string | E‑mailadres van afzender. |
data.to |
string | Ontvanger mailboxadres. |
data.mailbox_provider |
string | Postvakprovider: standard, gmail_alias, of outlook_alias. |
data.receivedAt |
string | Ontvangsttijd in de tijdzone van de applicatie, geformatteerd als YYYY-MM-DD HH:mm:ss. |
data.html |
boolean | Of het bericht een HTML-body heeft. |
data.html_content |
string | HTML-body wanneer aanwezig. Standaardberichten zonder HTML kunnen dit veld weglaten. Beschouw de berichtinhoud als onbetrouwbaar. |
data.text_content |
string | Tekstinhoud wanneer aanwezig; Standaardberichten kunnen escaped tekst in een pre-element bevatten of dit veld weglaten. |
data.content |
string | Voorkeursinhoud voor weergave, normaal HTML wanneer beschikbaar. |
data.attachments |
array | Bijlage‑metadata, of een lege array. Downloads vereisen normale authenticatie en toepasselijke PIN‑autorisatie. |
data.attachments[].name |
string | Bestandsnaam om te URL-coderen als één padsegment bij het downloaden. |
data.attachments[].size |
integer | Grootte van bijlage in bytes. |
data.attachments[].url |
string | Download-URL van de API voor geverifieerde gebruikers toegevoegd aan bijlagen met een bestandsnaam. Een URL garandeert niet dat het lokale bestand beschikbaar is. |
data.attachments[].extension |
string | Standaard/Gmail-metadataveld: bestandsextensie indien opgegeven. |
data.attachments[].id |
string | Outlook-metadataveld: provider-bijlage-ID. |
data.attachments[].content_type |
string | Outlook-metadataveld: MIME-inhoudstype. |
data.from_name |
string|null | Outlook-detailveld: originele afzendernaam. |
data.to_email |
string|null | Outlook detailveld: origineel ontvangeradres. |
data.received_at |
string|null | Outlook-detailveld: ISO-8601 ontvangen tijd. |
data.has_html |
boolean | Outlook-detailveld: of er een HTML-body bestaat. |
Bericht Verwijderen
Een enkel eigendomsbericht verwijderen.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
messageId
|
path | string | verplicht |
Unieke bericht-ID-tekenreeks om permanent te verwijderen.
|
X-Mailbox-Unlock
|
header | string | optioneel |
Header, alleen voor beveiligde mailboxen: gebruik de eenmalige delete unlock_token. Eerst POST pin, scope=delete en de action/target_id die wordt geretourneerd door de 423-respons op de PIN unlock URL. Een read token kan niet verwijderen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | optioneel |
Vereist voor PIN-beveiligde creatie of verwijdering: een stabiele sleutel van 16 tot 128 tekens. Probeer het identieke verzoek opnieuw met dezelfde sleutel om dubbel werk te voorkomen.
|
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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
200 OK • JSON{
"status": true,
"message": "Message was deleted successfully."
}
| Veld | Type | Beschrijving |
|---|---|---|
status |
boolean | Of de bewerking geslaagd is. |
message |
string | Resultaat van de verwijdering. Een ontbrekende bron geeft HTTP 404 terug. |
Bijlage downloaden
Download een bijlage van een bericht dat je bezit.
| Parameter | Locatie | Type | Status | Beschrijving |
|---|---|---|---|---|
messageId
|
path | string | verplicht |
ID van het bericht dat het bestand bevat.
|
filename
|
path | string | verplicht |
Bestandsnaam en extensie van de bijlage om te downloaden.
|
X-Mailbox-Unlock
|
header | string | optioneel |
Header, alleen beschermde mailboxen: gebruik een read unlock_token. Eerst POST pin en scope=read naar de PIN unlock URL. Houd uw normale Bearer-authenticatie. <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
| Veld | Type | Beschrijving |
|---|---|---|
Content-Disposition |
header | Succesvolle respons downloadt de gevraagde bestandsnaam. |
body |
binary | Bestandsbytes bij succes, niet JSON. Fouten retourneren JSON met een niet-2xx status. |
Limieten & Quotums
Bewaak real-time aanvraagbudgetten, snelheidslimieten en accountquota zonder credits te verbruiken.
Rate Limiet & Quotum
Controleer uw huidige limiet en quotastatus zonder enige API‑gebruik te verbruiken. Dit eindpunt is quotavrij en trekt geen maandelijkse API‑tegoed af (misbruikbeschermingslimiet: 60 verzoeken/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'
Illustratieve respons met synthetische gegevens. ID's, adressen, tokens, tijdstempels, planlimieten en aantallen variëren. Voorbeeldlevensduur overschrijft niet de standaard van uw plan. Beschrijvingen van responsvelden geven aan welke nullable en provider-specifieke velden zijn.
Voorbeeldantwoord
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"
}
}
}
| Veld | Type | Beschrijving |
|---|---|---|
data.limit |
integer|string | Accountverzoeken-per-minuut limiet. De tekenreeks unlimited duidt op een onbeperkt minuutbudget; dit is onafhankelijk van de maandelijkse quota. |
data.remaining |
integer|string | Resterende account minuutbudget slots, of de string unlimited. Een positieve waarde betekent niet dat API-credits overblijven. |
data.reset |
integer | Seconden voor het accountminuutvenster, niet de maandelijkse quotaherstelling. Uitgeschakelde of onbeperkte minuutbudgetten kunnen een nominale waarde van 60 seconden behouden; dit garandeert geen toegang na wachten. |
data.plan |
string | Huidige plan-tag. De leesbare plannaam wordt apart geleverd in data.quota.plan_name. |
data.quota.enabled |
boolean | Of globale en plan/credit API-toegang is ingeschakeld. Dit geeft geen indicatie van resterende capaciteit of vervangt de gebruikers-API-schakelaar. |
data.quota.user_api_status |
boolean | Of de gebruiker hun User API-schakelaar heeft ingeschakeld. Operaties vereisen deze schakelaar evenals ingeschakelde toegang en beschikbare capaciteit. |
data.quota.plan_name |
string | Leesbare naam van het huidige plan. |
data.quota.period |
string | Kalendermaand gebruiksperiode in YYYY-MM formaat, gebruikmakend van de toepassingstijdzone; niet noodzakelijk de factureringsperiode van het abonnement. |
data.quota.base_limit |
integer | Basis maandelijkse plantoewijzing. Een waarde van -1 betekent onbeperkt. |
data.quota.extra_requests |
integer | Extra maandelijkse toelage toegekend voor de huidige gebruiksperiode; gescheiden van gekochte credits. |
data.quota.monthly_limit |
integer | Basisvergoeding plus extra verzoeken van de huidige periode. Een waarde van -1 betekent onbeperkt. Aangeschafte credits zijn niet inbegrepen. |
data.quota.monthly_remaining |
integer|null | Resterende eindige maandelijkse toelage, of null wanneer de maandelijkse quota onbeperkt is. Null mag niet worden geïnterpreteerd als nul. |
data.quota.used |
integer | Succesvolle, getelde API-bewerkingen in de huidige gebruiksperiode, inclusief bewerkingen met credits. Statuscontroles verhogen deze waarde niet. |
data.quota.purchased_credits |
integer | Huidige creditbalans, inclusief bonuscredits van het actieve abonnement. Bonuscredits mogen niet een tweede keer aan deze balans worden toegevoegd. |
data.quota.bonus_credits |
integer | Actief planbonusdeel van het credit saldo; een uitsplitsing van purchased_credits, niet extra capaciteit. |
data.quota.direct_purchased_credits |
integer | Credietsaldo exclusief het actieve plan‑bonusgedeelte. Deze waarde plus bonus_credits is gelijk aan purchased_credits. |
data.quota.remaining |
integer|null | Maandelijks resterende toelage plus het huidige kredietsaldo, zonder bonussen dubbel te tellen. Null betekent onbeperkte maandelijkse quota. Individuele functiepermissies en andere aanvraaglimieten blijven van toepassing. |
data.quota.unlimited |
boolean | Of de maandelijkse quota onbeperkt is. Dit maakt het minutenbudget van het account of andere functielimieten niet onbeperkt. |
data.quota.usage_percent |
integer | Dashboard-compatibel afgerond percentage van 0 tot 100: gebruikt gedeeld door gebruikt plus resterend, vermenigvuldigd met 100. Het omvat beschikbare kredietcapaciteit, dus opladen kan het percentage verlagen. Het is 0 voor onbeperkte quota of een pool van nul grootte; het is niet het minuut‑rate‑limitpercentage of een toegangsbeslissing. |
data.quota.reset_at |
string | ISO-8601-tijdstempel met tijdzone-offset voor de volgende kalendermaand-quota-reset. Dit is niet de vervaldatum van het abonnement, en de maandelijkse reset vult gekochte credits niet bij. |
status |
string | De letterlijke succeswaarde voor dit status‑endpoint. Andere succesvolle mailbox‑endpoints gebruiken de booleaanse true. |
data.monthly_limit |
integer | Compatibiliteitsalias van het overeenkomstige data.quota-veld; voeg het niet opnieuw toe bij het berekenen van saldi. |
data.monthly_remaining |
integer|null | Compatibiliteitsalias van het overeenkomstige data.quota-veld; voeg het niet opnieuw toe bij het berekenen van saldi. |
data.purchased_credits |
integer | Compatibiliteitsalias van het overeenkomstige data.quota-veld; voeg het niet opnieuw toe bij het berekenen van saldi. |
Mailbox Webhooks (Echtijd-push)
In plaats van herhaaldelijk de REST API (GET /berichten) te pollen om te controleren op inkomend mail, configureert u Webhooks om nieuwe berichten in realtime naar uw server of automatiseringsworkflow te sturen.
Ondersteunde Webhook-gebeurtenissen
Elke webhook kan zich abonneren op één of meerdere gebeurtenistypen. Uw eindpunt ontvangt een gebeurtenisnotificatie wanneer een van deze triggers wordt uitgelokt.
In realtime verzonden zodra een nieuw bericht de geselecteerde mailbox bereikt.
Verzonden wanneer de tijdelijke mailbox verloopt en webhook‑verwerking wordt gepauzeerd.
Verzonden wanneer een verlopen mailbox opnieuw actief wordt volgens de planregels.
Verzonden vlak voordat de webhook en de bijbehorende mailbox worden verwijderd.
Vraagkopteksten & HMAC Handtekeningverificatie
Elke webhook-levering bevat speciale beveiligingskoppen. Gebruik de X-TempMailg-Signature-header om te verifiëren dat inkomende aanvragen echt zijn verzonden door TempMailg en niet zijn gewijzigd.
| Kopnaam | Voorbeeldwaarde | Beschrijving |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Standaardidentificatie voor de webhook-leveringswerker. |
X-TempMailg-Event |
email.received | Het type gebeurtenis dat deze levering heeft geactiveerd. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Unieke UUID toegewezen aan deze bezorgpoging. |
X-TempMailg-Timestamp |
1725192000 | Unix-epoch-tijdstempel die aangeeft wanneer het verzoek is geïnitieerd. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | HMAC-SHA256-handtekening berekend van {timestamp}.{raw_body} met uw geheime sleutel. |
X-TempMailg-Test |
false | Waar wanneer verzonden door de "Send Test Ping"-functie in uw dashboard. |
De handtekening wordt berekend met behulp van HMAC met SHA256 over de volgende string:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Voorbeeld-Evenementspayload (email.received)
Geleverd als toepassing/json in het lichaam van de HTTP POST-verzoek.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:18:09+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:09+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"
}
}
Voorbeelden van implementatie van ontvanger
Selecteer uw taal om te zien hoe u webhooks ontvangt en HMAC-handtekeningen veilig verifieert.
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]);
Ondersteunde platforms en automatiseringsintegraties
TempMailg Webhooks werken direct uit de doos met standaard HTTPS-eindpunten en toonaangevende no-code/automatiseringsplatformen:
Veelvoorkomende fouten en probleemoplossing
Dit zijn de meest voorkomende reactiecodes die u kunt zien tijdens het integreren van de gebruikers-API.
Ongeldig, ontbrekend of ingetrokken Bearer-token.
Eigendom, functiepermissies, domeintoegang of bijlagegrootte verhinderden de bewerking. Controleer de responscode en het bericht.
De resource is niet gevonden op de toegestane host of behoort niet tot de gebruiker.
De operatiesleutel is opnieuw gebruikt met andere details, er is een andere bewerking in behandeling, of de mailboxbeveiliging is gewijzigd. Inspecteer de code voordat u het opnieuw probeert.
Postbus is verlopen of inactief.
Ongeldige parameters, een niet-toegestane levensduur, onbeschikbare aliascapaciteit, ongeldige PIN-configuratie of een ontbrekende/ongeldige Idempotency-Key verhinderden de bewerking.
Een beveiligde mailbox heeft een geldig scoped X-Mailbox-Unlock token nodig. Gebruik de actie en target_id uit de respons voor verwijdering. Vergrendelings- of herstelvereisten moeten zijn opgelost voordat u het opnieuw probeert.
Een verzoeklimiet, uitgeschakeld plan, uitgeputte quota of cooldown verhinderde de bewerking. Controleer de reden en de beschikbare budget headers. Retry-After is optioneel.
De server kon de bewerking niet voltooien. Voor beschermde creatie of verwijdering, behoud dezelfde aanvraag en Idempotency-Key bij het opnieuw proberen.
Bescherming opslag of coördinatie kon niet worden geverifieerd. Probeer het opnieuw na de aangegeven vertraging. Deze reactie is geen mislukte betaling.
Snelle checklist
- 401 Unauthorized - Bearer-token ontbreekt, is onjuist, ingetrokken of verkeerd gekopieerd.
- 403 Forbidden - Het huidige plan heeft op dit moment geen toegang tot de gebruikers-API.
- 404 Not Found - Bron niet gevonden of ongeldig parameter
- 410 Gone / Expired - Postbus is verlopen of niet langer actief.
- 429 Rate Limited - Controleer de reden van de respons en de budgetheaders. Retry-After is alleen van toepassing op tijdsbeperkingen; uitgeputte credits of uitgeschakelde toegang kunnen een accountwijziging vereisen.
Aanbevolen volgende stap
Als u bent aangemeld, opent u eerst API Management en bevestigt u uw sleutel, quotum, plan-toegangstatus en de exacte User API-basissite-URL voordat u uw externe app debugt.