Kurze Einrichtungs-Checkliste
- Öffnen Sie die API-Verwaltungsseite Ihres Dashboards und erstellen Sie Ihren persönlichen API-Schlüssel.
- Kopieren Sie die dort angezeigte genaue Benutzer-API-Basis-URL, zum Beispiel https://v1.tempmailg.com/api.
- Senden Sie jede Anfrage an diesen API-Host mit Authorization: Bearer YOUR_USER_API_KEY und Accept: application/json.
- Verfolgen Sie Ihr monatliches Anforderungslimit auf derselben Dashboard‑Seite und über Quoten‑Header, wenn diese in den Benutzer‑API‑Antworten verfügbar sind. Nur erfolgreiche 2xx‑Anfragen zählen zum Kontingent.
Authentifizierungsablauf
- Generieren Sie Ihren persönlichen API-Schlüssel auf der Dashboard API-Management-Seite.
- Senden Sie den Schlüssel als Bearer-Token in jeder Anfrage.
- Verwenden Sie die dedizierte Benutzer-API-Basis-URL, die auf Ihrer API-Management-Seite angezeigt wird.
- Generieren Sie den Schlüssel jederzeit neu, wenn Sie den alten Schlüssel für ungültig erklären und sofort einen neuen Schlüssel verwenden möchten.
Erforderliche Header
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Ratenbegrenzung & Kontingent-Header
Rate-Limit-Header beschreiben das angegebene Anforderungsbudget. Quota-Header werden eingeschlossen, wenn Quota-Informationen verfügbar sind; Minute-Limit-Ablehnungen berechnen nicht Ihr volles monatliches Kontingent.
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— Maximale Anfragen pro Minute (RPM) für Ihren Plan.X-RateLimit-Remaining— Verbleibende RPM-Anfragen im aktuellen Minutenfenster.X-RateLimit-Reset— Unix-Zeitstempel, wenn das aktuelle Minuten‑Ratenlimit‑Fenster zurückgesetzt wird.X-Quota-Limit— Gesamte monatliche und gekaufte Kreditkapazität für Ihr Konto.X-Quota-Remaining— Verbleibende verfügbare API-Anfragen im aktuellen Monat.X-Quota-Used— Gesamte API-Anfragen, die im aktuellen Abrechnungszeitraum verbraucht wurden.X-Quota-Reset— ISO-8601-Zeitstempel, wenn Ihr monatliches Kontingent zurückgesetzt wird.X-RateLimit-Scope— Das Budget, das durch die Header beschrieben wird: account, ip, status_endpoint oder mailbox.X-Mailbox-RateLimit-*— Separates Budget für die Erstellung/Aktualisierung von Postfächern. Erfolgreiche Postfachantworten behalten das Konten‑RPM in X-RateLimit-*; eine reine Postfachablehnung verwendet den Postfachbereich und ihr eigenes Wiederholungsfenster.Retry-After— Sekunden, bis ein zeitgesteuerter Wiederholungsversuch angemessen ist. Ein deaktivierter Plan oder ein erschöpftes Kontingent kann stattdessen einen Kontowechsel erfordern, daher ist dieser Header nicht immer vorhanden.503 protection_unavailable— Der API-Schutzspeicher oder die Koordination ist vorübergehend nicht verfügbar. Versuchen Sie es später erneut; dies ist weder ein Zahlungsfehler noch eine Kreditabbuchung.
Postfachverwaltung
Erlaubte Domains abrufen, Postfächer erstellen oder wechseln, zulässige Laufzeiten auswählen und eigene Adressen löschen.
Erlaubte Domains auflisten
Liste verfügbare Domains für die Erstellung temporärer E-Mails auf. Filtere nach Typ, um nur kostenlose, Premium- oder benutzerdefinierte Domains zu sehen, die von deinem Abonnementplan unterstützt werden.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
type
|
query | string | optional |
Domain-Stufenfilter. Das Weglassen verwendet alle, wenn Premium-Domain-Zugriff aktiviert ist, sonst kostenlos. Anerkannte Werte: free, basic, pro, premium, custom, ultimate, all
Standard:
Kontenabhängig
|
const response = await fetch('https://v1.tempmailg.com/api/domains?type=free', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Request failed with status ${response.status}`);
}
const data = await response.json();
console.log(data);
import requests
headers = {
'Authorization': 'Bearer YOUR_USER_API_KEY',
'Accept': 'application/json',
}
response = requests.get('https://v1.tempmailg.com/api/domains?type=free', headers=headers, timeout=30)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://v1.tempmailg.com/api/domains?type=free');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_USER_API_KEY',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
var_dump($statusCode, json_decode($response, true));
curl --request GET \
--url 'https://v1.tempmailg.com/api/domains?type=free' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_USER_API_KEY'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
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
}
]
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
data.requested_type |
string | Domain-Filter angewendet. |
data.plan |
string | Aktuelles Plan-Tag. |
data.plan_name |
string | Lesbarer Name des aktuellen Plans. |
data.allowed_types |
array<string> | Domainfilter, die für dieses Konto verfügbar sind. Ein erkannter Filter kann dennoch für Ihren Plan gesperrt sein. |
data.domains |
array | Auswählbare Domains nach dem Filtern; ein leeres Array ist gültig. |
data.domains[].domain |
string | Auswählbarer Domainname. |
data.domains[].type |
string | Lesbares Domänen‑Stufen‑Label. |
data.domains[].custom |
boolean | Ob dies eine benutzerdefinierte Domain ist. |
Temporäres Postfach erstellen
Erstellen Sie ein eigenes temporäres Postfach. Lassen Sie Benutzername und Domain für eine zufällige Generierung weg oder geben Sie einen zulässigen benutzerdefinierten Benutzernamen und eine erlaubte Domain an. Der Parameter provider kann die Generierung von Gmail- oder Outlook-Alias auswählen.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
username
|
body | string | optional |
Optionaler benutzerdefinierter Benutzername: 2 bis 64 ASCII‑Buchstaben, Ziffern, Punkte, Unterstriche oder Bindestriche. Erfordert Planberechtigung; custom_username wird ebenfalls akzeptiert.
Standard:
Zufällig generiert
|
domain
|
body | string | optional |
Einer der erlaubten Domains, die von GET /domains zurückgegeben werden. Das Weglassen wählt eine zufällige erlaubte Domain aus.
Standard:
Zufällige erlaubte Domain
|
lifetime
|
body | string | optional |
erlaubte Werte:
10m — 10 Minuten
1h — 1 Stunde
2h — 2 Stunden
1d — 1 Tag
1w — 1 Woche
1m — 30 Tage
3m — 90 Tage
6m — 180 Tage
1y — 365 Tage
unlimited — Unbegrenzt
Standard:
Standardlebensdauer des Plans
|
provider
|
body | string | optional |
Mailbox-Anbieter: standard, gmail_alias oder outlook_alias.
Standard:
standard
|
pin_enabled
|
body | boolean | optional |
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard:
false
|
pin
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
|
pin_confirmation
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
|
Idempotency-Key
|
header | string | optional |
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
|
username (Benutzerdefinierter Benutzername, falls vom Plan erlaubt), domain (erlaubte Domain, z. B. example.com), lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"data": {
"id": 2301,
"pin_protected": false,
"email": "demo123@example.com",
"domain": "example.com",
"provider": "standard",
"expire_at": "2026-11-20T02:17:50+00:00",
"expires_in_seconds": 86399.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:50+00:00",
"email_token": "encrypted-email-token"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
data.id |
integer | Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach. |
data.pin_protected |
boolean | Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben. |
data.email |
string | Vollständige Postfachadresse generiert. |
data.domain |
string | Domain des erzeugten Postfachs. |
data.provider |
string | Mailbox-Anbieter: standard, gmail_alias oder outlook_alias. |
data.expire_at |
string|null | Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach. |
data.expires_in_seconds |
number|null | Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null. |
data.mailbox_state |
string | Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv. |
data.receiving_enabled |
boolean | Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert. |
data.message_count |
integer | Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln. |
data.unread_message_count |
integer | Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln. |
data.last_message_received_at |
string|null | Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar. |
data.message_count_synced_at |
string|null | Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation. |
data.created_at |
string|null | Mailbox-Erstellungszeit im ISO-8601-Format. |
data.email_token |
string | Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung. |
data.pin_grant |
object | Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist. |
data.pin_grant.unlock_token |
string | Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung. |
data.pin_grant.scope |
string | Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen. |
data.pin_grant.idle_timeout_seconds |
integer | Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden. |
data.pin_grant.expires_at |
string | Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format. |
data.pin_grant.absolute_expires_at |
string | Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen. |
Postfach aktualisieren / wechseln
Erstellen oder wählen Sie ein Postfach mit dem neuen Benutzernamen und der Domain, nachdem Sie den Besitz des aktuellen Postfachs verifiziert haben. Dies benennt das alte Postfach nicht um und ändert dessen Lebensdauer nicht. Wenn das Ziel abweicht, bleibt das alte Postfach in der Historie und kann durch aktive-Postfach‑Grenzen pausiert werden. Die Wiederverwendung Ihres eigenen aktiven Ziels wendet dessen angeforderte Lebensdauer oder den Standardplan erneut an.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
email
|
path | string | erforderlich |
Aktuelle vollständige E-Mail-Adresse des zu wechselnden eigenen Postfachs. URL-codieren Sie jedes Pfadsegment; kodieren Sie ein Pluszeichen als %2B.
|
username
|
path | string | erforderlich |
Neuer gewünschter Benutzername: 2 bis 64 alphanumerische Zeichen; abhängig von der Berechtigung für benutzerdefinierte Benutzernamen.
|
domain
|
path | string | erforderlich |
Neuer zulässiger Domainname.
|
lifetime
|
body | string | optional |
erlaubte Werte:
10m — 10 Minuten
1h — 1 Stunde
2h — 2 Stunden
1d — 1 Tag
1w — 1 Woche
1m — 30 Tage
3m — 90 Tage
6m — 180 Tage
1y — 365 Tage
unlimited — Unbegrenzt
Standard:
Standardlebensdauer des Plans
|
pin_enabled
|
body | boolean | optional |
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard:
false
|
pin
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
|
pin_confirmation
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
|
Idempotency-Key
|
header | string | optional |
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
|
X-Mailbox-Unlock
|
header | string | optional |
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"data": {
"id": 2302,
"pin_protected": false,
"email": "demo123@example.com",
"domain": "example.com",
"provider": "standard",
"expire_at": "2026-11-19T02:27:50+00:00",
"expires_in_seconds": 599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:50+00:00",
"email_token": "encrypted-email-token"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
data.id |
integer | Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach. |
data.pin_protected |
boolean | Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben. |
data.email |
string | Vollständige Postfachadresse generiert. |
data.domain |
string | Domain des erzeugten Postfachs. |
data.provider |
string | Mailbox-Anbieter: standard, gmail_alias oder outlook_alias. |
data.expire_at |
string|null | Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach. |
data.expires_in_seconds |
number|null | Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null. |
data.mailbox_state |
string | Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv. |
data.receiving_enabled |
boolean | Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert. |
data.message_count |
integer | Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln. |
data.unread_message_count |
integer | Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln. |
data.last_message_received_at |
string|null | Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar. |
data.message_count_synced_at |
string|null | Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation. |
data.created_at |
string|null | Mailbox-Erstellungszeit im ISO-8601-Format. |
data.email_token |
string | Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung. |
data.pin_grant |
object | Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist. |
data.pin_grant.unlock_token |
string | Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung. |
data.pin_grant.scope |
string | Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen. |
data.pin_grant.idle_timeout_seconds |
integer | Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden. |
data.pin_grant.expires_at |
string | Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format. |
data.pin_grant.absolute_expires_at |
string | Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen. |
Postfach löschen
Löschen Sie ein eigenes Postfach und führen Sie dessen Nachrichten- und Dateibereinigung durch. Beibehaltene Postfachdatensätze können intern soft-gelöscht werden; die Adresse ist über die API nicht mehr nutzbar.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
email
|
path | string | erforderlich |
Vollständige E-Mail-Adresse des zu löschenden eigenen Postfachs. URL-encode die Adresse; encode ein Pluszeichen als %2B.
|
X-Mailbox-Unlock
|
header | string | optional |
Header, nur geschützte Postfächer: Verwenden Sie das einmalig nutzbare Delete‑unlock_token. Zuerst POST pin, scope=delete und die von der 423‑Antwort zurückgegebene action/target_id an die PIN‑unlock URL. Ein Lese‑Token kann nicht löschen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | optional |
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
|
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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"message": "Email has been successfully deleted."
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
message |
string | Ergebnis der Löschung. Eine fehlende Ressource liefert HTTP 404. |
Gmail & Outlook Aliase
Erstelle Gmail- und Outlook/Hotmail-Alias-Postfächer mit hoher Reputation.
Gmail-Alias erstellen
Erstellen Sie ein neues temporäres Gmail-Alias-Postfach, das dem authentifizierten Benutzer gehört.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
mode
|
body | string | optional |
Generierungsmodus: auto, dot, plus oder plus_dot. Akzeptiert außerdem gmail_alias_mode. Wenn die Stilauswahl nicht erlaubt ist, wird auto verwendet.
Standard:
auto
|
username
|
body | string | optional |
Optionaler benutzerdefinierter Alias-Suffix: 2 bis 32 ASCII-Buchstaben oder Ziffern, in Kleinbuchstaben normalisiert; abhängig von der Funktionsberechtigung. Akzeptiert außerdem custom_username oder alias_username.
Standard:
Automatisch generiert
|
domain
|
body | string | optional |
Verwenden Sie zufällig, gmail.com oder googlemail.com; alias_domain wird ebenfalls akzeptiert. Bei Weglassen oder wenn die Domainauswahl nicht verfügbar ist, wird zufällig verwendet.
Standard:
random
|
lifetime
|
body | string | optional |
erlaubte Werte:
10m — 10 Minuten
1h — 1 Stunde
2h — 2 Stunden
1d — 1 Tag
1w — 1 Woche
1m — 30 Tage
3m — 90 Tage
6m — 180 Tage
1y — 365 Tage
unlimited — Unbegrenzt
Standard:
Standardlebensdauer des Plans
|
pin_enabled
|
body | boolean | optional |
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard:
false
|
pin
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
|
pin_confirmation
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
|
Idempotency-Key
|
header | string | optional |
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
|
mode (auto, dot, plus, plus_dot), username (Benutzerdefinierter Alias-Benutzername), domain (z. B. gmail.com, googlemail.com), lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"data": {
"id": 2305,
"pin_protected": false,
"email": "example+alias123@gmail.com",
"domain": "gmail.com",
"provider": "gmail_alias",
"expire_at": "2026-11-19T03:17:50+00:00",
"expires_in_seconds": 3599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:50+00:00",
"email_token": "encrypted-email-token"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
data.id |
integer | Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach. |
data.pin_protected |
boolean | Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben. |
data.email |
string | Vollständige Postfachadresse generiert. |
data.domain |
string | Domain des erzeugten Postfachs. |
data.provider |
string | Mailbox-Anbieter: standard, gmail_alias oder outlook_alias. |
data.expire_at |
string|null | Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach. |
data.expires_in_seconds |
number|null | Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null. |
data.mailbox_state |
string | Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv. |
data.receiving_enabled |
boolean | Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert. |
data.message_count |
integer | Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln. |
data.unread_message_count |
integer | Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln. |
data.last_message_received_at |
string|null | Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar. |
data.message_count_synced_at |
string|null | Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation. |
data.created_at |
string|null | Mailbox-Erstellungszeit im ISO-8601-Format. |
data.email_token |
string | Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung. |
data.pin_grant |
object | Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist. |
data.pin_grant.unlock_token |
string | Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung. |
data.pin_grant.scope |
string | Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen. |
data.pin_grant.idle_timeout_seconds |
integer | Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden. |
data.pin_grant.expires_at |
string | Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format. |
data.pin_grant.absolute_expires_at |
string | Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen. |
Outlook-Alias-Domänen
Abrufen aktiver Outlook-/Hotmail-Alias-Domains, die für die Postfachgenerierung verfügbar sind.
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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
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
}
]
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
data.domains |
array | Aktive Outlook/Hotmail-Domains; ein leeres Array ist gültig. |
data.domains[].domain |
string | Verfügbarer Domainname. |
data.domains[].type |
string | Lesbare Anbieterbezeichnung. |
data.domains[].selectable |
boolean | Ob Ihr Konto diese Domain ausdrücklich auswählen darf. |
data.domains[].locked |
boolean | Ob die explizite Domänenauswahl für Ihr Konto gesperrt ist. |
data.domains[].disabled_reason |
string|null | Grund, warum die Domainauswahl gesperrt ist, oder null, wenn auswählbar. |
Outlook-Alias erstellen
Erstellen Sie ein neues Outlook / Hotmail Alias-Temporärpostfach, das dem authentifizierten Benutzer gehört.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
domain
|
body | string | optional |
Verwenden Sie zufällig oder eine Domain von GET /outlook-alias/domains; outlook_alias_domain wird ebenfalls akzeptiert. Ohne Auswahlberechtigung wird zufällig verwendet.
Standard:
Zufällige verfügbare Domain
|
username
|
body | string | optional |
Optionaler benutzerdefinierter Alias-Suffix: 2 bis 32 ASCII-Buchstaben oder Ziffern, in Kleinbuchstaben normalisiert; abhängig von der Funktionsberechtigung. Akzeptiert außerdem custom_username oder alias_username.
Standard:
Automatisch generiert
|
lifetime
|
body | string | optional |
erlaubte Werte:
10m — 10 Minuten
1h — 1 Stunde
2h — 2 Stunden
1d — 1 Tag
1w — 1 Woche
1m — 30 Tage
3m — 90 Tage
6m — 180 Tage
1y — 365 Tage
unlimited — Unbegrenzt
Standard:
Standardlebensdauer des Plans
|
pin_enabled
|
body | boolean | optional |
Optionaler PIN-Schutz für das neue Postfach, sofern von Ihrem Plan erlaubt. Er ändert nicht den PIN eines bestehenden Postfachs.
Standard:
false
|
pin
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist: eine PIN von 6 bis 8 Ziffern, als String gesendet, um führende Nullen zu erhalten.
|
pin_confirmation
|
body | string | optional |
Erforderlich, wenn pin_enabled true ist. Muss exakt mit pin übereinstimmen.
|
Idempotency-Key
|
header | string | optional |
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
|
domain (z. B. outlook.com, hotmail.com), username (Benutzerdefinierter Alias-Benutzername), lifetime (erlaubte Werte: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Lassen Sie die Lebensdauer weg, oder lassen Sie das Feld leer, um die für Ihren aktuellen monatlichen/jährlichen Plan konfigurierte Standard‑E‑Mail‑Lebensdauer zu verwenden. Senden Sie eine zulässige Lebensdauer, z. B. 1 h, um diesen Standard zu überschreiben. Unbegrenzt wird nur verwendet, wenn es als Planstandard konfiguriert ist oder ausdrücklich angefordert und erlaubt wird. Die Body-Parameter mailbox_lifetime und email_lifetime werden ebenfalls akzeptiert; der erste nicht-leere Wert gewinnt in dieser Reihenfolge: lifetime, mailbox_lifetime, email_lifetime. Ungültige oder nicht erlaubte Werte geben HTTP 422 zurück, anstatt stillschweigend einen Standardwert auszuwählen.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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"data": {
"id": 2306,
"pin_protected": false,
"email": "example+alias45@outlook.com",
"domain": "outlook.com",
"provider": "outlook_alias",
"expire_at": "2026-11-19T03:17:50+00:00",
"expires_in_seconds": 3599.75,
"mailbox_state": "active",
"receiving_enabled": true,
"message_count": 0,
"unread_message_count": 0,
"last_message_received_at": null,
"message_count_synced_at": null,
"created_at": "2026-11-19T02:17:50+00:00",
"email_token": "encrypted-email-token"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
data.id |
integer | Postfach-ID. Generierte IDs, Adressen und Tokens unterscheiden sich für jedes Postfach. |
data.pin_protected |
boolean | Ob dieses Postfach PIN-Schutz hat. Keine PIN oder PIN-Hash wird zurückgegeben. |
data.email |
string | Vollständige Postfachadresse generiert. |
data.domain |
string | Domain des erzeugten Postfachs. |
data.provider |
string | Mailbox-Anbieter: standard, gmail_alias oder outlook_alias. |
data.expire_at |
string|null | Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach. |
data.expires_in_seconds |
number|null | Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null. |
data.mailbox_state |
string | Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv. |
data.receiving_enabled |
boolean | Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert. |
data.message_count |
integer | Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln. |
data.unread_message_count |
integer | Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln. |
data.last_message_received_at |
string|null | Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar. |
data.message_count_synced_at |
string|null | Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation. |
data.created_at |
string|null | Mailbox-Erstellungszeit im ISO-8601-Format. |
data.email_token |
string | Undurchsichtige verschlüsselte Postfachreferenz. Sie ersetzt nicht die Bearer-Authentifizierung, Eigentumsprüfungen oder PIN-Autorisierung. |
data.pin_grant |
object | Bedingt: Aktive PIN-geschützte Postfach-Erstellung gibt diese Leseberechtigung zurück; gewöhnliche ungeschützte Erstellung lässt sie weg. |
data.pin_grant.mailbox_id |
integer | Mailbox-ID, an die die bedingte Leseberechtigung gebunden ist. |
data.pin_grant.unlock_token |
string | Undurchsichtiger Lesetoken für X-Mailbox-Unlock mit denselben Eigentümer-Anmeldeinformationen. Halten Sie ihn privat und im Speicher; ein Leserecht autorisiert keine Löschung. |
data.pin_grant.scope |
string | Der Umfang wird für die bedingte Erstellungsgenehmigung gelesen. |
data.pin_grant.idle_timeout_seconds |
integer | Zulässige Leerlaufzeit für die Leseberechtigung, normalerweise 3600 Sekunden. |
data.pin_grant.absolute_timeout_seconds |
integer | Maximale Lebensdauer der Leseberechtigung, normalerweise 86400 Sekunden. |
data.pin_grant.expires_at |
string | Aktuelles Ablaufdatum der Leseberechtigung im ISO-8601-Format. |
data.pin_grant.absolute_expires_at |
string | Absolutes Ablaufdatum der Leseberechtigung im ISO-8601-Format. Sicherheitsänderungen können die Berechtigung früher widerrufen. |
Nachrichten & Anhänge
Abrufen eingehender Postfächer, vollständige HTML-/Textnachrichten lesen und Anhänge streamen.
Postfachnachrichten auflisten
Rufen Sie verfügbare Nachrichtenübersichten und Postfach-Metadaten ab. Standardmäßige Posteingangs‑Scans geben einen aktuellen Stapel von bis zu 25 Nachrichten zurück; dies ist kein paginiertes Vollverlauf‑Endpunkt. Verwenden Sie GET /messages/{messageId} für vollständige Nachrichteninhalte und Anhänge.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
email
|
query | string | erforderlich |
Vollständige E-Mail-Adresse des eigenen Postfachs, aus dem Nachrichten gelesen werden sollen. URL-codieren Sie den Abfragewert; codieren Sie ein Pluszeichen als %2B.
|
X-Mailbox-Unlock
|
header | string | optional |
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"mailbox": "demo123@example.com",
"email_token": "encrypted-email-token",
"messages": [
{
"is_seen": false,
"subject": "Welcome to Temp Mail",
"from": "Example Sender",
"from_email": "hello@example.org",
"receivedAt": "2026-11-19 02:17:50",
"id": "ap94AWDg123ELQz07vrVB9dLXlbqZM5NGwYxOJKko8n6m1",
"otp": null,
"otp_locked": false,
"verification_link": null,
"verification_link_locked": false
}
],
"mailbox_provider": "standard",
"mailbox_state": "active",
"expire_at": "2026-11-20T02:17:50+00:00",
"expires_in_seconds": 86399.75,
"receiving_enabled": true,
"mailbox_limit": {
"limit": 50,
"limit_label": "50",
"active_count": 1,
"paused_count": 0,
"paused_mailboxes": [],
"remaining": 49,
"remaining_label": "49",
"reached": false,
"blocked": false,
"provider": "standard"
},
"message_count": 1,
"unread_message_count": 1,
"last_message_received_at": "2026-11-19T02:17:50+00:00",
"message_count_synced_at": "2026-11-19T02:17:50+00:00"
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
mailbox |
string | Postfachadresse, deren Nachrichten angefordert wurden. |
email_token |
string | Undurchsichtige verschlüsselte Postfachreferenz; normale Authentifizierung ist weiterhin erforderlich. |
mailbox_provider |
string | Mailbox-Anbieter: standard, gmail_alias oder outlook_alias. |
messages |
array | Nachrichtenzusammenfassungen. Ein leerer Posteingang gibt ein leeres Array zurück; rufen Sie eine einzelne Nachricht für deren Inhalt und Anhänge ab. |
expire_at |
string|null | Wirksames Ablaufdatum als ISO-8601-Zeitstempel, oder null für ein unbegrenztes Postfach. |
expires_in_seconds |
number|null | Nicht-negative Sekunden verbleibend bei Berechnung; Bruchteile von Sekunden sind möglich. Null bedeutet unbegrenzt, nicht null. |
mailbox_state |
string | Aktueller Postfachstatus: aktiv, pausiert, abgelaufen oder inaktiv. |
receiving_enabled |
boolean | Ob dieses Postfach derzeit eingehende Nachrichten akzeptiert. |
message_count |
integer | Bekannte Gesamtanzahl der Nachrichten; sie kann die letzte Postfach‑Synchronisation widerspiegeln. |
unread_message_count |
integer | Bekannte Anzahl ungelesener Nachrichten; sie kann die letzte Postfachsynchronisation widerspiegeln. |
last_message_received_at |
string|null | Letzte bekannte Empfangszeit der Nachricht im ISO‑8601-Format, oder null, wenn nicht verfügbar. |
message_count_synced_at |
string|null | Letzte Synchronisationszeit der Nachrichtenanzahl im ISO-8601-Format, oder null vor der Synchronisation. |
mailbox_limit.limit |
integer | Aktives Postfachlimit für diesen Anbieter; -1 bedeutet unbegrenzt. |
mailbox_limit.limit_label |
string | Anzeigeetikett für das Postfachlimit. |
mailbox_limit.active_count |
integer | Anzahl der aktiven Postfächer für diesen Anbieter. |
mailbox_limit.paused_count |
integer | Anzahl der pausierten Postfächer für diesen Anbieter. |
mailbox_limit.paused_mailboxes |
array<string> | Adressen wurden aufgrund des Postfachlimits pausiert. |
mailbox_limit.remaining |
integer | Verbleibende aktive Postfachplätze; -1 bedeutet unbegrenzt. Dies ist kein API-Anfragekontingent. |
mailbox_limit.remaining_label |
string | Anzeigebezeichnung für verbleibende Postfachplätze. |
mailbox_limit.reached |
boolean | Ob das aktive Postfachlimit erreicht wurde. |
mailbox_limit.blocked |
boolean | Ob das aktive Postfachlimit Null ist. |
mailbox_limit.provider |
string|null | Anbieter, für den das Postfachlimit gilt. |
messages[].id |
string | Undurchsichtige Nachrichten-ID, die von den Endpunkten für Einzelnachrichten, Löschung und Anhang verwendet wird. |
messages[].is_seen |
boolean | Ob die Nachricht als gelesen markiert ist. |
messages[].subject |
string | Nachrichtenthema. |
messages[].from |
string | Anzeigename oder Adresse des Absenders. |
messages[].from_email |
string | Absender-E-Mail-Adresse. |
messages[].receivedAt |
string | Empfangszeit in der Zeitzone der Anwendung, formatiert als YYYY-MM-DD HH:mm:ss. |
messages[].otp |
string|null | Erkannte Einmalcode, wenn verfügbar und erlaubt; andernfalls null. |
messages[].otp_locked |
boolean | Ob ein erkannter Einmalcode durch Funktionsberechtigungen verborgen ist. |
messages[].verification_link |
string|null | Erkannte Verifizierungs-URL, wenn verfügbar und erlaubt; andernfalls null. |
messages[].verification_link_locked |
boolean | Ob ein erkannter Verifizierungslink durch Funktionsberechtigungen verborgen ist. |
messages[].from_name |
string|null | Outlook-Zusammenfassungsfeld: Name des ursprünglichen Absenders. Nicht in Standard- und Gmail-Zusammenfassungen enthalten. |
messages[].snippet |
string|null | Outlook‑Zusammenfassungsfeld: Kurze Nachrichtenvorschau. |
messages[].received_at |
string|null | Outlook‑Zusammenfassungsfeld: ISO‑8601‑Empfangszeit, falls bekannt. |
messages[].has_attachments |
boolean | Outlook-Zusammenfassungsfeld: ob Anhang-Metadaten vorhanden sind. Die Verfügbarkeit des Downloads wird separat geprüft. |
Einzelne Nachricht abrufen
Rufen Sie eine eigene Nachricht anhand ihrer undurchsichtigen Nachrichten-ID ab. Gibt Body-Formate und Anhangs-Metadaten zurück. Body-Felder hängen vom Nachrichtenformat ab; Outlook fügt die unten aufgeführten anbieterspezifischen Felder hinzu.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
messageId
|
path | string | erforderlich |
Eindeutige Nachrichten-ID, die in der Nachrichtenliste zurückgegeben wird.
|
X-Mailbox-Unlock
|
header | string | optional |
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"data": {
"is_seen": true,
"subject": "Welcome to Temp Mail",
"from": "Example Sender",
"from_email": "hello@example.org",
"to": "demo123@example.com",
"mailbox_provider": "standard",
"receivedAt": "2026-11-19 02:17:50",
"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"
}
]
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
data.id |
string | Undurchsichtige Nachrichten-ID. |
data.is_seen |
boolean | Nachrichten-Lesezustand. Das Lesen kann es als gesehen markieren; zwischengespeicherte Daten können einen früheren Zustand widerspiegeln. |
data.subject |
string | Nachrichtenthema. |
data.from |
string | Anzeigename oder Adresse des Absenders. |
data.from_email |
string | Absender-E-Mail-Adresse. |
data.to |
string | Empfängerpostfachadresse. |
data.mailbox_provider |
string | Mailbox-Anbieter: standard, gmail_alias oder outlook_alias. |
data.receivedAt |
string | Empfangszeit in der Zeitzone der Anwendung, formatiert als YYYY-MM-DD HH:mm:ss. |
data.html |
boolean | Ob die Nachricht einen HTML-Body hat. |
data.html_content |
string | HTML-Body, falls vorhanden. Standardnachrichten ohne HTML können dieses Feld weglassen. Behandeln Sie den Nachrichteninhalt als nicht vertrauenswürdig. |
data.text_content |
string | Textkörper, wenn vorhanden; Standardnachrichten können escaped Text in einem pre-Element enthalten oder dieses Feld weglassen. |
data.content |
string | Bevorzugter Body für die Anzeige, normalerweise HTML, wenn verfügbar. |
data.attachments |
array | Anhangs-Metadaten oder ein leeres Array. Downloads erfordern normale Authentifizierung und anwendbare PIN‑Autorisierung. |
data.attachments[].name |
string | Dateiname, der beim Herunterladen als einzelnes Pfadsegment URL-codiert werden soll. |
data.attachments[].size |
integer | Anhanggröße in Bytes. |
data.attachments[].url |
string | Authentifizierte Benutzer‑API‑Download‑URL zu Anhängen mit einem Dateinamen hinzugefügt. Eine URL garantiert nicht, dass die lokale Datei verfügbar ist. |
data.attachments[].extension |
string | Standard-/Gmail-Metadatenfeld: Dateierweiterung, falls angegeben. |
data.attachments[].id |
string | Outlook-Metadatenfeld: Provider-Anhang-ID. |
data.attachments[].content_type |
string | Outlook-Metadatenfeld: MIME-Inhaltstyp. |
data.from_name |
string|null | Outlook-Detailfeld: Originalabsendername. |
data.to_email |
string|null | Outlook-Detailfeld: ursprüngliche Empfängeradresse. |
data.received_at |
string|null | Outlook-Detailfeld: ISO-8601-Empfangszeit. |
data.has_html |
boolean | Outlook-Detailfeld: ob ein HTML-Body vorhanden ist. |
Nachricht löschen
Löschen Sie eine einzelne eigene Nachricht.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
messageId
|
path | string | erforderlich |
Eindeutige Nachrichten-ID-Zeichenkette zum dauerhaften Löschen.
|
X-Mailbox-Unlock
|
header | string | optional |
Header, nur geschützte Postfächer: Verwenden Sie das einmalig nutzbare Delete‑unlock_token. Zuerst POST pin, scope=delete und die von der 423‑Antwort zurückgegebene action/target_id an die PIN‑unlock URL. Ein Lese‑Token kann nicht löschen. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | optional |
Erforderlich für PIN-geschützte Erstellung oder Löschung: ein stabiler Schlüssel mit 16 bis 128 Zeichen. Wiederholen Sie die identische Anfrage mit demselben Schlüssel, um doppelte Arbeit zu vermeiden.
|
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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
200 OK • JSON{
"status": true,
"message": "Message was deleted successfully."
}
| Feld | Typ | Beschreibung |
|---|---|---|
status |
boolean | Ob die Operation erfolgreich war. |
message |
string | Ergebnis der Löschung. Eine fehlende Ressource liefert HTTP 404. |
Anhang herunterladen
Einen Anhang von einer eigenen Nachricht herunterladen.
| Parameter | Ort | Typ | Status | Beschreibung |
|---|---|---|---|---|
messageId
|
path | string | erforderlich |
ID der Nachricht, die die Datei enthält.
|
filename
|
path | string | erforderlich |
Dateiname und Erweiterung des Anhangs zum Herunterladen.
|
X-Mailbox-Unlock
|
header | string | optional |
Header, nur geschützte Postfächer: Verwenden Sie ein read unlock_token. Senden Sie zuerst POST pin und scope=read an die PIN-Entsperr-URL. Behalten Sie Ihre normale Bearer-Authentifizierung bei. <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
| Feld | Typ | Beschreibung |
|---|---|---|
Content-Disposition |
header | Erfolgreiche Antwort lädt den angeforderten Dateinamen herunter. |
body |
binary | Dateibytes bei Erfolg, nicht JSON. Fehler geben JSON mit einem Nicht-2xx-Status zurück. |
Ratenlimits & Kontingente
Überwachen Sie Echtzeit-Anfragebudgets, Ratenlimits und Kontingente, ohne Credits zu verbrauchen.
Ratenbegrenzung & Kontingent
Überprüfen Sie Ihr aktuelles Rate‑Limit und den Kontingentstatus, ohne API‑Nutzung zu verbrauchen. Dieser Endpunkt ist kontingentfrei und zieht keine monatlichen API‑Credits ab (Missbrauchsschutz‑Limit: 60 Anfragen/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'
Veranschaulichende Antwort mit synthetischen Daten. IDs, Adressen, Tokens, Zeitstempel, Planlimits und Zähler variieren. Beispielhafte Lebensdauern überschreiben nicht die Standardwerte Ihres Plans. Beschreibungen der Antwortfelder identifizieren nullable und anbieterspezifische Felder.
Beispielantwort
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"
}
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
data.limit |
integer|string | Konto-Anfragen-pro-Minute-Limit. Der String unlimited bezeichnet ein unbegrenztes Minutenbudget; dies ist unabhängig vom monatlichen Kontingent. |
data.remaining |
integer|string | Verbleibende Kontominuten-Budgetplätze, oder der String unlimited. Ein positiver Wert bedeutet nicht, dass API-Guthaben verbleiben. |
data.reset |
integer | Sekunden für das Minutenfenster des Kontos, nicht für den monatlichen Kontingent-Reset. Deaktivierte oder unbegrenzte Minutenbudgets können einen nominalen Wert von 60 Sekunden beibehalten; dies garantiert keinen Zugriff nach dem Warten. |
data.plan |
string | Aktuelles Plan-Tag. Der lesbare Planname wird separat in data.quota.plan_name bereitgestellt. |
data.quota.enabled |
boolean | Ob globaler und Plan-/Kredit-API-Zugriff aktiviert ist. Dies gibt keinen Aufschluss über die verbleibende Kapazität und ersetzt nicht den Benutzer‑API‑Schalter. |
data.quota.user_api_status |
boolean | Ob der Benutzer seinen User-API-Schalter aktiviert hat. Vorgänge erfordern diesen Schalter sowie aktivierten Zugriff und verfügbare Kapazität. |
data.quota.plan_name |
string | Lesbarer Name des aktuellen Plans. |
data.quota.period |
string | Kalender-Monats-Nutzungszeitraum im Format YYYY-MM, unter Verwendung der Anwendungszeitzone; nicht unbedingt der Abrechnungszeitraum des Abonnements. |
data.quota.base_limit |
integer | Basis-Monatsplan-Kontingent. Ein Wert von -1 bedeutet unbegrenzt. |
data.quota.extra_requests |
integer | Zusätzliche monatliche Zuteilung für den aktuellen Nutzungszeitraum gewährt; getrennt von gekauften Credits. |
data.quota.monthly_limit |
integer | Grundfreigabe plus zusätzliche Anfragen des aktuellen Zeitraums. Ein Wert von -1 bedeutet unbegrenzt. Gekaufte Credits sind nicht enthalten. |
data.quota.monthly_remaining |
integer|null | Verbleibendes endliches monatliches Kontingent oder null, wenn das monatliche Kontingent unbegrenzt ist. Null darf nicht als Null interpretiert werden. |
data.quota.used |
integer | Erfolgreiche, gezählte API-Operationen im aktuellen Nutzungszeitraum, einschließlich Operationen mit Credits. Statusprüfungen erhöhen diesen Wert nicht. |
data.quota.purchased_credits |
integer | Aktueller Guthabenstand, einschließlich Bonusguthaben des aktiven Plans. Bonusguthaben dürfen diesem Saldo nicht ein zweites Mal hinzugefügt werden. |
data.quota.bonus_credits |
integer | Aktiver Plan-Bonusanteil des Guthabens; eine Aufschlüsselung von purchased_credits, nicht zusätzliche Kapazität. |
data.quota.direct_purchased_credits |
integer | Guthaben ohne den aktiven plan-bonus Teil. Dieser Wert plus bonus_credits entspricht purchased_credits. |
data.quota.remaining |
integer|null | Monatliches Restkontingent plus das aktuelle Guthaben, ohne Bonus doppelt zu zählen. Null bedeutet unbegrenztes monatliches Kontingent. Individuelle Funktionsberechtigungen und andere Anforderungsgrenzen gelten weiterhin. |
data.quota.unlimited |
boolean | Ob das monatliche Kontingent unbegrenzt ist. Dies macht das Minutenbudget des Kontos oder andere Funktionslimits nicht unbegrenzt. |
data.quota.usage_percent |
integer | Dashboard-kompatibler gerundeter Prozentsatz von 0 bis 100: verwendet geteilt durch verwendet plus verbleibend, multipliziert mit 100. Er beinhaltet die verfügbare Kreditkapazität, sodass Aufladen den Prozentsatz senken kann. Er ist 0 für unbegrenztes Kontingent oder einen Pool mit Größe Null; er ist nicht der Minuten‑Rate‑Limit‑Prozentsatz oder eine Zugriffsentscheidung. |
data.quota.reset_at |
string | ISO-8601-Zeitstempel mit Zeitzonenoffset für den nächsten Kalendermonats-Quota-Reset. Dies ist nicht das Ablaufdatum des Abonnements, und der monatliche Reset füllt gekaufte Credits nicht auf. |
status |
string | Der wörtliche Erfolg für diesen Status-Endpunkt. Andere erfolgreiche Postfach-Endpunkte verwenden den booleschen Wert true. |
data.monthly_limit |
integer | Kompatibilitätsalias des entsprechenden data.quota-Feldes; nicht erneut hinzufügen, wenn Salden berechnet werden. |
data.monthly_remaining |
integer|null | Kompatibilitätsalias des entsprechenden data.quota-Feldes; nicht erneut hinzufügen, wenn Salden berechnet werden. |
data.purchased_credits |
integer | Kompatibilitätsalias des entsprechenden data.quota-Feldes; nicht erneut hinzufügen, wenn Salden berechnet werden. |
E-Mail-Postfach-Webhooks (Echtzeit-Push)
Statt die REST-API (GET /messages) wiederholt abzufragen, um auf eingehende E-Mails zu prüfen, konfigurieren Sie Webhooks, um neue Nachrichten in Echtzeit an Ihren Server oder Ihre Automatisierungsworkflows zu senden.
Unterstützte Webhook-Ereignisse
Jeder Webhook kann sich auf eine oder mehrere Ereignistypen abonnieren. Ihre Endpoint erhält eine Ereignismeldung, sobald einer dieser Auslöser aktiviert wird.
Echtzeitversand, sobald eine neue Nachricht das ausgewählte Postfach erreicht.
Wird gesendet, wenn das temporäre mailbox abläuft und die webhook processing pausiert wird.
Wird gesendet, wenn ein abgelaufenes Postfach gemäß den Planregeln wieder aktiv wird.
Gesendet unmittelbar bevor der Webhook und sein Postfach gelöscht werden.
Anfragenköpfe & HMAC-Signaturprüfung
Jede Webhook-Lieferung enthält spezielle Sicherheitsheader. Verwenden Sie den X-TempMailg-Signature-Header, um zu überprüfen, dass eingehende Anfragen tatsächlich von TempMailg verschickt wurden und nicht manipuliert wurden.
| Überschrift | Beispielwert | Beschreibung |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Standardkennung für den Webhook-Zustellungs-Worker. |
X-TempMailg-Event |
email.received | Der Typ des Ereignisses, das diese Zustellung ausgelöst hat. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Eindeutige UUID, die diesem Zustellungsversuch zugewiesen wurde. |
X-TempMailg-Timestamp |
1725192000 | Unix-Epoch-Zeitstempel, der angibt, wann die Anfrage initiiert wurde. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | HMAC-SHA256-Signatur, berechnet aus {timestamp}.{raw_body} mit Ihrem Geheimschlüssel. |
X-TempMailg-Test |
false | Wahr, wenn es durch die "Send Test Ping"-Funktion in Ihrem Dashboard gesendet wird. |
Die Signatur wird mit HMAC und SHA256 über den folgenden String berechnet:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Beispiel-Ereignisdaten (email.received)
Wird als application/json im HTTP POST-Anfragekörper übermittelt.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:17:50+00:00",
"test": false,
"mailbox": {
"id": 1024,
"email": "developer@v1.tempmailg.com"
},
"data": {
"message_id": "7a8b9c0d1e2f",
"subject": "Your Verification Code: 948201",
"from": "auth@service.com",
"to": "developer@v1.tempmailg.com",
"date": "2026-11-19T02:17:50+00:00",
"attachments_count": 0,
"text_preview": "Hello, your one-time verification code is 948201. It will expire in 10 minutes.",
"email_url": "https://tempmailg.com/mailbox/1024?message=7a8b9c0d1e2f",
"inbox_url": "https://tempmailg.com/mailbox/1024"
}
}
Beispielimplementierungen für Empfänger
Wählen Sie Ihre Sprache aus, um zu sehen, wie Sie Webhooks empfangen und HMAC‑Signaturen sicher überprüfen.
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]);
Unterstützte Plattformen & Automatisierungsintegrationen
TempMailg Webhooks funktionieren sofort mit standardmäßigen HTTPS-Endpunkten und führenden No-Code-/Automatisierungsplattformen:
Häufige Fehler und Fehlerbehebung
Dies sind die häufigsten Antwortcodes, die Ihnen bei der Integration der Benutzer-API begegnen können.
Ungültiges, fehlendes oder widerrufenes Bearer-Token.
Eigentum, Funktionsberechtigungen, Domain‑Zugriff oder Anhangsgröße haben die Operation verhindert. Überprüfen Sie den Antwortcode und die Meldung.
Die Ressource wurde auf dem erlaubten Host nicht gefunden oder gehört nicht dem Benutzer.
Der Operation-Schlüssel wurde mit unterschiedlichen Details erneut verwendet, eine andere Operation ist ausstehend oder die Postfachsicherheit hat sich geändert. Überprüfen Sie den Code, bevor Sie es erneut versuchen.
Postfach abgelaufen oder inaktiv.
Ungültige Parameter, eine nicht zulässige Lebensdauer, nicht verfügbare Alias‑Kapazität, ungültige PIN‑Einrichtung oder ein fehlender/ungültiger Idempotency‑Key haben die Operation verhindert.
Ein geschütztes Postfach benötigt ein gültiges, scoped X-Mailbox-Unlock-Token. Verwenden Sie die Aktion und target_id aus der Antwort für die Löschung. Sperr- oder Wiederherstellungsanforderungen müssen gelöst werden, bevor Sie es erneut versuchen.
Ein Anforderungslimit, deaktivierter Plan, erschöpftes Kontingent oder Abkühlzeit verhinderten die Operation. Überprüfen Sie den Grund und die verfügbaren Budget-Header. Retry-After ist optional.
Der Server konnte den Vorgang nicht abschließen. Bei geschützter Erstellung oder Löschung bewahren Sie dieselbe Anforderung und den Idempotency-Key bei einem erneuten Versuch.
Der Schutzspeicher oder die Koordination konnte nicht verifiziert werden. Versuchen Sie es nach der angegebenen Verzögerung erneut. Diese Antwort ist keine fehlgeschlagene Zahlung.
Schnelle Checkliste
- 401 Unauthorized - Bearer-Token fehlt, ist falsch, wurde widerrufen oder falsch kopiert.
- 403 Forbidden - Aktueller Plan hat derzeit keinen Benutzer-API-Zugriff.
- 404 Not Found - Ressource nicht gefunden oder ungültiger Parameter
- 410 Gone / Expired - Mailbox abgelaufen oder nicht mehr aktiv.
- 429 Rate Limited - Überprüfen Sie den Grund der Antwort und die Budget-Header. Retry-After gilt nur für zeitliche Beschränkungen; erschöpfte Credits oder deaktivierter Zugriff können eine Kontenänderung erfordern.
Empfohlener nächster Schritt
Wenn Sie angemeldet sind, öffnen Sie zuerst die API-Verwaltung und bestätigen Sie Ihren Schlüssel, Ihr Kontingent, Ihren Planzugriffsstatus und die genaue User API Base URL, bevor Sie Ihre externe App debuggen.