Hızlı kurulum kontrol listesi
- API Yönetimi panonuzu açın ve kişisel API anahtarınızı oluşturun.
- Orada gösterilen tam Kullanıcı API Temel URL'sini kopyalayın, örneğin https://v1.tempmailg.com/api.
- Her isteği o API hostuna Authorization: Bearer YOUR_USER_API_KEY ve Accept: application/json.
- Aylık istek kotanızı aynı gösterge paneli sayfasından ve kullanıcı API yanıtlarında mevcut olduğunda kota başlıklarından izleyin. Yalnızca başarılı 2xx istekler kota içinde sayılır.
Kimlik doğrulama akışı
- Kişisel API anahtarınızı panelden API Yönetim sayfasından oluşturun.
- Her istekte anahtarı Bearer token olarak gönderin.
- API Yönetim sayfanızda gösterilen özel Kullanıcı API Temel URL'sini kullanın.
- Eski anahtarı geçersiz kılmak ve hemen yeni bir anahtar kullanmak istediğinizde anahtarı yenileyin.
Gerekli başlıklar
Authorization: Bearer YOUR_USER_API_KEY
Accept: application/json
Hız Sınırı & Kota Başlıkları
Rate-limit başlıkları belirtilen istek bütçesini açıklar. Kota başlıkları, kota bilgisi mevcut olduğunda dahil edilir; dakika sınırlaması reddetmeleri tam aylık kotanızı hesaplamaz.
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— Planınız için dakikada izin verilen maksimum istek sayısı (RPM).X-RateLimit-Remaining— Mevcut dakikalık pencere içinde kalan RPM istekleri.X-RateLimit-Reset— Mevcut dakikalık oran sınırlama penceresinin sıfırlandığı Unix zaman damgası.X-Quota-Limit— Hesabınız için toplam aylık ve satın alınan kredi kapasitesi.X-Quota-Remaining— Mevcut ayda kalan kullanılabilir API istekleri.X-Quota-Used— Mevcut faturalama dönemi boyunca tüketilen toplam API istekleri.X-Quota-Reset— Aylık kotanızın sıfırlandığı ISO-8601 zaman damgası.X-RateLimit-Scope— Başlıklar tarafından tanımlanan bütçe: account, ip, status_endpoint veya mailbox.X-Mailbox-RateLimit-*— Ayrı posta kutusu oluşturma/güncelleme bütçesi. Başarılı posta kutusu yanıtları, hesabın RPM'sini X-RateLimit-* içinde tutar; yalnızca posta kutusu reddi, posta kutusu kapsamını ve kendi yeniden deneme penceresini kullanır.Retry-After— Zamanlanmış bir yeniden denemenin uygun olacağı saniyeler. Devre dışı bırakılmış bir plan veya tükenmiş kota yerine bir hesap değişikliği gerektirebilir, bu yüzden bu başlık her zaman mevcut olmayabilir.503 protection_unavailable— API koruma depolama veya koordinasyonu geçici olarak kullanılamıyor. Daha sonra tekrar deneyin; bu bir ödeme hatası veya kredi kesintisi değildir.
Posta Kutusu Yönetimi
İzin verilen alan adlarını getir, posta kutularını oluştur veya değiştir, izin verilen ömürleri seç ve sahip olunan adresleri sil.
İzin Verilen Alan Adlarını Listele
Geçici e-postalar oluşturmak için kullanılabilir alan adlarını listeleyin. Türüne göre filtreleyerek abonelik planınız tarafından desteklenen yalnızca ücretsiz, premium veya özel alan adlarını görün.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
type
|
query | string | isteğe bağlı |
Alan adı katman filtresi. Atlanması, premium-domain erişimi etkin olduğunda tümünü, aksi takdirde ücretsiz olanı kullanır. Tanınan değerler: free, basic, pro, premium, custom, ultimate, all
Varsayılan:
Hesaba bağlı
|
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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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
}
]
}
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
data.requested_type |
string | Uygulanan alan adı filtresi. |
data.plan |
string | Mevcut plan etiketi. |
data.plan_name |
string | Mevcut planın okunabilir adı. |
data.allowed_types |
array<string> | Bu hesap için kullanılabilir alan adı filtreleri. Tanınan bir filtre yine de planınız için yasaklanabilir. |
data.domains |
array | Filtreleme sonrası seçilebilir alan adları; boş bir dizi geçerlidir. |
data.domains[].domain |
string | Seçilebilir alan adı. |
data.domains[].type |
string | Okunabilir alan adı katman etiketi. |
data.domains[].custom |
boolean | Bunun özel bir alan adı olup olmadığı. |
Geçici Posta Kutusu Oluştur
Sahip olunan geçici bir posta kutusu oluşturun. Rastgele oluşturma için kullanıcı adını ve alan adını atlayın, ya da izin verilen özel bir kullanıcı adı ve izin verilen bir alan adı sağlayın. Sağlayıcı parametresi Gmail veya Outlook takma ad oluşturmayı seçebilir.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
username
|
body | string | isteğe bağlı |
İsteğe bağlı özel kullanıcı adı: 2 ile 64 ASCII harf, rakam, nokta, alt çizgi veya tire. Plan izni gerektirir; custom_username da kabul edilir.
Varsayılan:
Rastgele oluşturulmuş
|
domain
|
body | string | isteğe bağlı |
GET /domains tarafından döndürülen izin verilen alan adlarından biri. Atlama, rastgele bir izin verilen alan adı seçer.
Varsayılan:
Rastgele izin verilen alan
|
lifetime
|
body | string | isteğe bağlı |
izin verilen değerler:
10m — 10 Dakika
1h — 1 Saat
2h — 2 Saat
1d — 1 Gün
1w — 1 Hafta
1m — 30 Gün
3m — 90 gün
6m — 180 Gün
1y — 365 Gün
unlimited — Sınırsız
Varsayılan:
Plan varsayılan ömrü
|
provider
|
body | string | isteğe bağlı |
Posta kutusu sağlayıcısı: standard, gmail_alias, veya outlook_alias.
Varsayılan:
standard
|
pin_enabled
|
body | boolean | isteğe bağlı |
Planınız tarafından izin verildiğinde yeni posta kutusu için isteğe bağlı PIN koruması. Mevcut bir posta kutusunun PIN'ini değiştirmez.
Varsayılan:
false
|
pin
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir: baştaki sıfırları korumak için dize olarak gönderilen, 6 ila 8 haneli bir PIN.
|
pin_confirmation
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir. Pin ile tam olarak eşleşmelidir.
|
Idempotency-Key
|
header | string | isteğe bağlı |
PIN korumalı oluşturma veya silme için gereklidir: sabit 16 ila 128 karakter uzunluğunda bir anahtar. Aynı anahtarı kullanarak aynı isteği tekrarlayın, böylece yinelenen işi önleyin.
|
username (plan tarafından izin veriliyorsa özel kullanıcı adı), domain (izin verilen alan, ör. example.com), lifetime (izin verilen değerler: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited), provider (standard, gmail_alias, outlook_alias). Ömür süresini atlayın veya boş bırakın, böylece mevcut aylık/yıllık planınız için yapılandırılmış Varsayılan E-posta Ömür Süresi kullanılacaktır. Bu varsayılanı geçersiz kılmak için 1h gibi izin verilen bir ömür süresi gönderin. Sınırsız yalnızca plan varsayılanı olarak yapılandırıldığında veya açıkça talep edilip izin verildiğinde kullanılır. Gövde parametreleri mailbox_lifetime ve email_lifetime da kabul edilir; ilk boş olmayan değer şu sırayla kazanır: lifetime, mailbox_lifetime, email_lifetime. Geçersiz veya izin verilmeyen değerler, varsayılanı sessizce seçmek yerine HTTP 422 döndürür.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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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:53+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:53+00:00",
"email_token": "encrypted-email-token"
}
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
data.id |
integer | Posta kutusu kimliği. Oluşturulan kimlikler, adresler ve tokenlar her posta kutusu için farklıdır. |
data.pin_protected |
boolean | Bu posta kutusunun PIN koruması olup olmadığı. PIN veya PIN karması döndürülmez. |
data.email |
string | Tam posta kutusu adresi oluşturuldu. |
data.domain |
string | Oluşturulan posta kutusunun alan adı. |
data.provider |
string | Posta kutusu sağlayıcısı: standard, gmail_alias, veya outlook_alias. |
data.expire_at |
string|null | ISO-8601 zaman damgası olarak geçerli son tarih, sınırsız posta kutusu için null. |
data.expires_in_seconds |
number|null | Hesaplandığında kalan negatif olmayan saniyeler; kesirli saniyeler mümkündür. Null sınırsız anlamına gelir, sıfır değil. |
data.mailbox_state |
string | Mevcut posta kutusu durumu: aktif, duraklatılmış, süresi dolmuş veya pasif. |
data.receiving_enabled |
boolean | Bu posta kutusunun şu anda gelen mesajları kabul edip etmediği. |
data.message_count |
integer | Bilinen toplam mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.unread_message_count |
integer | Bilinen okunmamış mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.last_message_received_at |
string|null | ISO-8601 formatında son bilinen alınan mesaj zamanı, mevcut olmadığında null. |
data.message_count_synced_at |
string|null | ISO-8601 formatında son mesaj sayısı senkronizasyon zamanı, senkronizasyondan önce ise null. |
data.created_at |
string|null | Posta kutusu oluşturulma zamanı ISO-8601 formatında. |
data.email_token |
string | Opak şifreli posta kutusu referansı. Bearer kimlik doğrulamasını, sahiplik kontrollerini veya PIN yetkilendirmesini yerine geçmez. |
data.pin_grant |
object | Koşullu: aktif PIN korumalı posta kutusu oluşturma bu okuma iznini döndürür; sıradan korumasız oluşturma bunu atlar. |
data.pin_grant.mailbox_id |
integer | Koşullu okuma izninin bağlı olduğu posta kutusu kimliği. |
data.pin_grant.unlock_token |
string | Aynı sahibi kimlik bilgileriyle X-Mailbox-Unlock için opak okuma belirteci. Özel tutun ve bellekte saklayın; bir okuma izni silme yetkisi vermez. |
data.pin_grant.scope |
string | Koşullu oluşturma izni için okunan kapsam. |
data.pin_grant.idle_timeout_seconds |
integer | Okuma izni için izin verilen boşta kalma süresi, genellikle 3600 saniyedir. |
data.pin_grant.absolute_timeout_seconds |
integer | Okuma izninin maksimum süresi, genellikle 86400 saniyedir. |
data.pin_grant.expires_at |
string | Mevcut okuma izni süresi sonu ISO-8601 formatında. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 formatında mutlak okuma izni süresi. Güvenlik değişiklikleri izni daha erken iptal edebilir. |
Posta Kutusunu Güncelle / Değiştir
Mevcut posta kutusunun sahipliğini doğruladıktan sonra yeni kullanıcı adı ve alan adında bir posta kutusu oluşturun veya seçin. Bu, eski posta kutusunun adını değiştirmez veya ömrünü yerinde değiştirmez. Hedef farklı olduğunda, eski posta kutusu geçmişte kalır ve aktif posta kutusu limitleri tarafından duraklatılabilir. Kendi aktif hedefinizi yeniden kullanmak, istenen ömrünü veya plan varsayılanını yeniden uygular.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
email
|
path | string | gerekli |
Değiştirilecek sahip olunan posta kutusunun mevcut tam e-posta adresi. Her yol segmentini URL kodlayın; artı işaretini %2B olarak kodlayın.
|
username
|
path | string | gerekli |
Yeni istenen kullanıcı adı: 2 ila 64 alfanümerik karakter; özel kullanıcı adı iznine tabidir.
|
domain
|
path | string | gerekli |
Yeni izin verilen alan adı.
|
lifetime
|
body | string | isteğe bağlı |
izin verilen değerler:
10m — 10 Dakika
1h — 1 Saat
2h — 2 Saat
1d — 1 Gün
1w — 1 Hafta
1m — 30 Gün
3m — 90 gün
6m — 180 Gün
1y — 365 Gün
unlimited — Sınırsız
Varsayılan:
Plan varsayılan ömrü
|
pin_enabled
|
body | boolean | isteğe bağlı |
Planınız tarafından izin verildiğinde yeni posta kutusu için isteğe bağlı PIN koruması. Mevcut bir posta kutusunun PIN'ini değiştirmez.
Varsayılan:
false
|
pin
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir: baştaki sıfırları korumak için dize olarak gönderilen, 6 ila 8 haneli bir PIN.
|
pin_confirmation
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir. Pin ile tam olarak eşleşmelidir.
|
Idempotency-Key
|
header | string | isteğe bağlı |
PIN korumalı oluşturma veya silme için gereklidir: sabit 16 ila 128 karakter uzunluğunda bir anahtar. Aynı anahtarı kullanarak aynı isteği tekrarlayın, böylece yinelenen işi önleyin.
|
X-Mailbox-Unlock
|
header | string | isteğe bağlı |
Başlık, yalnızca korumalı posta kutuları: bir okuma unlock_token kullanın. İlk olarak PIN ve scope=read'i PIN kilit açma URL'sine POST edin. Normal Bearer kimlik doğrulamanızı koruyun. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
lifetime (izin verilen değerler: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Ömür süresini atlayın veya boş bırakın, böylece mevcut aylık/yıllık planınız için yapılandırılmış Varsayılan E-posta Ömür Süresi kullanılacaktır. Bu varsayılanı geçersiz kılmak için 1h gibi izin verilen bir ömür süresi gönderin. Sınırsız yalnızca plan varsayılanı olarak yapılandırıldığında veya açıkça talep edilip izin verildiğinde kullanılır. Gövde parametreleri mailbox_lifetime ve email_lifetime da kabul edilir; ilk boş olmayan değer şu sırayla kazanır: lifetime, mailbox_lifetime, email_lifetime. Geçersiz veya izin verilmeyen değerler, varsayılanı sessizce seçmek yerine HTTP 422 döndürür.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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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:53+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:53+00:00",
"email_token": "encrypted-email-token"
}
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
data.id |
integer | Posta kutusu kimliği. Oluşturulan kimlikler, adresler ve tokenlar her posta kutusu için farklıdır. |
data.pin_protected |
boolean | Bu posta kutusunun PIN koruması olup olmadığı. PIN veya PIN karması döndürülmez. |
data.email |
string | Tam posta kutusu adresi oluşturuldu. |
data.domain |
string | Oluşturulan posta kutusunun alan adı. |
data.provider |
string | Posta kutusu sağlayıcısı: standard, gmail_alias, veya outlook_alias. |
data.expire_at |
string|null | ISO-8601 zaman damgası olarak geçerli son tarih, sınırsız posta kutusu için null. |
data.expires_in_seconds |
number|null | Hesaplandığında kalan negatif olmayan saniyeler; kesirli saniyeler mümkündür. Null sınırsız anlamına gelir, sıfır değil. |
data.mailbox_state |
string | Mevcut posta kutusu durumu: aktif, duraklatılmış, süresi dolmuş veya pasif. |
data.receiving_enabled |
boolean | Bu posta kutusunun şu anda gelen mesajları kabul edip etmediği. |
data.message_count |
integer | Bilinen toplam mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.unread_message_count |
integer | Bilinen okunmamış mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.last_message_received_at |
string|null | ISO-8601 formatında son bilinen alınan mesaj zamanı, mevcut olmadığında null. |
data.message_count_synced_at |
string|null | ISO-8601 formatında son mesaj sayısı senkronizasyon zamanı, senkronizasyondan önce ise null. |
data.created_at |
string|null | Posta kutusu oluşturulma zamanı ISO-8601 formatında. |
data.email_token |
string | Opak şifreli posta kutusu referansı. Bearer kimlik doğrulamasını, sahiplik kontrollerini veya PIN yetkilendirmesini yerine geçmez. |
data.pin_grant |
object | Koşullu: aktif PIN korumalı posta kutusu oluşturma bu okuma iznini döndürür; sıradan korumasız oluşturma bunu atlar. |
data.pin_grant.mailbox_id |
integer | Koşullu okuma izninin bağlı olduğu posta kutusu kimliği. |
data.pin_grant.unlock_token |
string | Aynı sahibi kimlik bilgileriyle X-Mailbox-Unlock için opak okuma belirteci. Özel tutun ve bellekte saklayın; bir okuma izni silme yetkisi vermez. |
data.pin_grant.scope |
string | Koşullu oluşturma izni için okunan kapsam. |
data.pin_grant.idle_timeout_seconds |
integer | Okuma izni için izin verilen boşta kalma süresi, genellikle 3600 saniyedir. |
data.pin_grant.absolute_timeout_seconds |
integer | Okuma izninin maksimum süresi, genellikle 86400 saniyedir. |
data.pin_grant.expires_at |
string | Mevcut okuma izni süresi sonu ISO-8601 formatında. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 formatında mutlak okuma izni süresi. Güvenlik değişiklikleri izni daha erken iptal edebilir. |
Posta Kutusunu Sil
Sahip olunan bir posta kutusunu silin ve mesaj ve dosya temizliğini başlatın. Saklanan posta kutusu kayıtları dahili olarak yumuşak silme işlemine tabi tutulabilir; adres API üzerinden artık kullanılamaz.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
email
|
path | string | gerekli |
Silinecek sahip olunan posta kutusunun tam e-posta adresi. Adresi URL kodlayın; artı işaretini %2B olarak kodlayın.
|
X-Mailbox-Unlock
|
header | string | isteğe bağlı |
Başlık, yalnızca korumalı posta kutuları: tek kullanımlık silme unlock_token kullanın. İlk POST pin, scope=delete ve 423 yanıtı tarafından PIN kilidi açma URL'sine döndürülen action/target_id. Okuma token'ı silemez. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | isteğe bağlı |
PIN korumalı oluşturma veya silme için gereklidir: sabit 16 ila 128 karakter uzunluğunda bir anahtar. Aynı anahtarı kullanarak aynı isteği tekrarlayın, böylece yinelenen işi önleyin.
|
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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
200 OK • JSON{
"status": true,
"message": "Email has been successfully deleted."
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
message |
string | Silme sonucu. Eksik bir kaynak HTTP 404 döndürür. |
Gmail ve Outlook Takma Adları
Yüksek itibarlı Gmail ve Outlook/Hotmail takma ad posta kutuları oluşturun.
Gmail Takma Adı Oluştur
Kimliği doğrulanmış kullanıcıya ait yeni bir Gmail takma adı geçici posta kutusu oluşturun.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
mode
|
body | string | isteğe bağlı |
Oluşturma modu: auto, dot, plus veya plus_dot. Ayrıca gmail_alias_mode kabul eder. Stil seçimine izin verilmezse, auto kullanılır.
Varsayılan:
auto
|
username
|
body | string | isteğe bağlı |
İsteğe bağlı özel takma ad son eki: 2 ila 32 ASCII harf veya rakam, küçük harfe normalleştirilir; özellik iznine tabidir. Ayrıca custom_username veya alias_username kabul eder.
Varsayılan:
Otomatik oluşturulmuş
|
domain
|
body | string | isteğe bağlı |
Rastgele, gmail.com veya googlemail.com kullanın; alias_domain da kabul edilir. Atlama veya mevcut olmayan domain-seçim izni rastgele kullanır.
Varsayılan:
random
|
lifetime
|
body | string | isteğe bağlı |
izin verilen değerler:
10m — 10 Dakika
1h — 1 Saat
2h — 2 Saat
1d — 1 Gün
1w — 1 Hafta
1m — 30 Gün
3m — 90 gün
6m — 180 Gün
1y — 365 Gün
unlimited — Sınırsız
Varsayılan:
Plan varsayılan ömrü
|
pin_enabled
|
body | boolean | isteğe bağlı |
Planınız tarafından izin verildiğinde yeni posta kutusu için isteğe bağlı PIN koruması. Mevcut bir posta kutusunun PIN'ini değiştirmez.
Varsayılan:
false
|
pin
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir: baştaki sıfırları korumak için dize olarak gönderilen, 6 ila 8 haneli bir PIN.
|
pin_confirmation
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir. Pin ile tam olarak eşleşmelidir.
|
Idempotency-Key
|
header | string | isteğe bağlı |
PIN korumalı oluşturma veya silme için gereklidir: sabit 16 ila 128 karakter uzunluğunda bir anahtar. Aynı anahtarı kullanarak aynı isteği tekrarlayın, böylece yinelenen işi önleyin.
|
mode (auto, dot, plus, plus_dot), username (özel takma ad kullanıcı adı), domain (örn. gmail.com, googlemail.com), lifetime (izin verilen değerler: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Ömür süresini atlayın veya boş bırakın, böylece mevcut aylık/yıllık planınız için yapılandırılmış Varsayılan E-posta Ömür Süresi kullanılacaktır. Bu varsayılanı geçersiz kılmak için 1h gibi izin verilen bir ömür süresi gönderin. Sınırsız yalnızca plan varsayılanı olarak yapılandırıldığında veya açıkça talep edilip izin verildiğinde kullanılır. Gövde parametreleri mailbox_lifetime ve email_lifetime da kabul edilir; ilk boş olmayan değer şu sırayla kazanır: lifetime, mailbox_lifetime, email_lifetime. Geçersiz veya izin verilmeyen değerler, varsayılanı sessizce seçmek yerine HTTP 422 döndürür.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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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:53+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:53+00:00",
"email_token": "encrypted-email-token"
}
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
data.id |
integer | Posta kutusu kimliği. Oluşturulan kimlikler, adresler ve tokenlar her posta kutusu için farklıdır. |
data.pin_protected |
boolean | Bu posta kutusunun PIN koruması olup olmadığı. PIN veya PIN karması döndürülmez. |
data.email |
string | Tam posta kutusu adresi oluşturuldu. |
data.domain |
string | Oluşturulan posta kutusunun alan adı. |
data.provider |
string | Posta kutusu sağlayıcısı: standard, gmail_alias, veya outlook_alias. |
data.expire_at |
string|null | ISO-8601 zaman damgası olarak geçerli son tarih, sınırsız posta kutusu için null. |
data.expires_in_seconds |
number|null | Hesaplandığında kalan negatif olmayan saniyeler; kesirli saniyeler mümkündür. Null sınırsız anlamına gelir, sıfır değil. |
data.mailbox_state |
string | Mevcut posta kutusu durumu: aktif, duraklatılmış, süresi dolmuş veya pasif. |
data.receiving_enabled |
boolean | Bu posta kutusunun şu anda gelen mesajları kabul edip etmediği. |
data.message_count |
integer | Bilinen toplam mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.unread_message_count |
integer | Bilinen okunmamış mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.last_message_received_at |
string|null | ISO-8601 formatında son bilinen alınan mesaj zamanı, mevcut olmadığında null. |
data.message_count_synced_at |
string|null | ISO-8601 formatında son mesaj sayısı senkronizasyon zamanı, senkronizasyondan önce ise null. |
data.created_at |
string|null | Posta kutusu oluşturulma zamanı ISO-8601 formatında. |
data.email_token |
string | Opak şifreli posta kutusu referansı. Bearer kimlik doğrulamasını, sahiplik kontrollerini veya PIN yetkilendirmesini yerine geçmez. |
data.pin_grant |
object | Koşullu: aktif PIN korumalı posta kutusu oluşturma bu okuma iznini döndürür; sıradan korumasız oluşturma bunu atlar. |
data.pin_grant.mailbox_id |
integer | Koşullu okuma izninin bağlı olduğu posta kutusu kimliği. |
data.pin_grant.unlock_token |
string | Aynı sahibi kimlik bilgileriyle X-Mailbox-Unlock için opak okuma belirteci. Özel tutun ve bellekte saklayın; bir okuma izni silme yetkisi vermez. |
data.pin_grant.scope |
string | Koşullu oluşturma izni için okunan kapsam. |
data.pin_grant.idle_timeout_seconds |
integer | Okuma izni için izin verilen boşta kalma süresi, genellikle 3600 saniyedir. |
data.pin_grant.absolute_timeout_seconds |
integer | Okuma izninin maksimum süresi, genellikle 86400 saniyedir. |
data.pin_grant.expires_at |
string | Mevcut okuma izni süresi sonu ISO-8601 formatında. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 formatında mutlak okuma izni süresi. Güvenlik değişiklikleri izni daha erken iptal edebilir. |
Outlook Takma Ad Alanları
Posta kutusu oluşturma için mevcut aktif Outlook / Hotmail takma ad alanlarını getir.
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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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
}
]
}
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
data.domains |
array | Aktif Outlook/Hotmail alan adları; boş bir dizi geçerlidir. |
data.domains[].domain |
string | Kullanılabilir alan adı. |
data.domains[].type |
string | Okunabilir sağlayıcı etiketi. |
data.domains[].selectable |
boolean | Hesabınızın bu alan adını açıkça seçip seçemeyeceği. |
data.domains[].locked |
boolean | Açık alan adı seçiminin hesabınız için kilitli olup olmadığı. |
data.domains[].disabled_reason |
string|null | Alan adı seçiminin kilitli olma nedeni, seçilebilir olduğunda null olur. |
Outlook Takma Adı Oluştur
Kimliği doğrulanmış kullanıcıya ait yeni bir Outlook / Hotmail takma adı geçici posta kutusu oluştur.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
domain
|
body | string | isteğe bağlı |
Rastgele bir alan adı veya GET /outlook-alias/domains'den bir alan adı kullanın; outlook_alias_domain da kabul edilir. Seçim izni olmadan, rastgele kullanılır.
Varsayılan:
Rastgele kullanılabilir alan adı
|
username
|
body | string | isteğe bağlı |
İsteğe bağlı özel takma ad son eki: 2 ila 32 ASCII harf veya rakam, küçük harfe normalleştirilir; özellik iznine tabidir. Ayrıca custom_username veya alias_username kabul eder.
Varsayılan:
Otomatik oluşturulmuş
|
lifetime
|
body | string | isteğe bağlı |
izin verilen değerler:
10m — 10 Dakika
1h — 1 Saat
2h — 2 Saat
1d — 1 Gün
1w — 1 Hafta
1m — 30 Gün
3m — 90 gün
6m — 180 Gün
1y — 365 Gün
unlimited — Sınırsız
Varsayılan:
Plan varsayılan ömrü
|
pin_enabled
|
body | boolean | isteğe bağlı |
Planınız tarafından izin verildiğinde yeni posta kutusu için isteğe bağlı PIN koruması. Mevcut bir posta kutusunun PIN'ini değiştirmez.
Varsayılan:
false
|
pin
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir: baştaki sıfırları korumak için dize olarak gönderilen, 6 ila 8 haneli bir PIN.
|
pin_confirmation
|
body | string | isteğe bağlı |
pin_enabled true olduğunda gereklidir. Pin ile tam olarak eşleşmelidir.
|
Idempotency-Key
|
header | string | isteğe bağlı |
PIN korumalı oluşturma veya silme için gereklidir: sabit 16 ila 128 karakter uzunluğunda bir anahtar. Aynı anahtarı kullanarak aynı isteği tekrarlayın, böylece yinelenen işi önleyin.
|
domain (örn. outlook.com, hotmail.com), username (özel takma ad kullanıcı adı), lifetime (izin verilen değerler: 10m, 1h, 2h, 1d, 1w, 1m, 3m, 6m, 1y, unlimited). Ömür süresini atlayın veya boş bırakın, böylece mevcut aylık/yıllık planınız için yapılandırılmış Varsayılan E-posta Ömür Süresi kullanılacaktır. Bu varsayılanı geçersiz kılmak için 1h gibi izin verilen bir ömür süresi gönderin. Sınırsız yalnızca plan varsayılanı olarak yapılandırıldığında veya açıkça talep edilip izin verildiğinde kullanılır. Gövde parametreleri mailbox_lifetime ve email_lifetime da kabul edilir; ilk boş olmayan değer şu sırayla kazanır: lifetime, mailbox_lifetime, email_lifetime. Geçersiz veya izin verilmeyen değerler, varsayılanı sessizce seçmek yerine HTTP 422 döndürür.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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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:53+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:53+00:00",
"email_token": "encrypted-email-token"
}
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
data.id |
integer | Posta kutusu kimliği. Oluşturulan kimlikler, adresler ve tokenlar her posta kutusu için farklıdır. |
data.pin_protected |
boolean | Bu posta kutusunun PIN koruması olup olmadığı. PIN veya PIN karması döndürülmez. |
data.email |
string | Tam posta kutusu adresi oluşturuldu. |
data.domain |
string | Oluşturulan posta kutusunun alan adı. |
data.provider |
string | Posta kutusu sağlayıcısı: standard, gmail_alias, veya outlook_alias. |
data.expire_at |
string|null | ISO-8601 zaman damgası olarak geçerli son tarih, sınırsız posta kutusu için null. |
data.expires_in_seconds |
number|null | Hesaplandığında kalan negatif olmayan saniyeler; kesirli saniyeler mümkündür. Null sınırsız anlamına gelir, sıfır değil. |
data.mailbox_state |
string | Mevcut posta kutusu durumu: aktif, duraklatılmış, süresi dolmuş veya pasif. |
data.receiving_enabled |
boolean | Bu posta kutusunun şu anda gelen mesajları kabul edip etmediği. |
data.message_count |
integer | Bilinen toplam mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.unread_message_count |
integer | Bilinen okunmamış mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
data.last_message_received_at |
string|null | ISO-8601 formatında son bilinen alınan mesaj zamanı, mevcut olmadığında null. |
data.message_count_synced_at |
string|null | ISO-8601 formatında son mesaj sayısı senkronizasyon zamanı, senkronizasyondan önce ise null. |
data.created_at |
string|null | Posta kutusu oluşturulma zamanı ISO-8601 formatında. |
data.email_token |
string | Opak şifreli posta kutusu referansı. Bearer kimlik doğrulamasını, sahiplik kontrollerini veya PIN yetkilendirmesini yerine geçmez. |
data.pin_grant |
object | Koşullu: aktif PIN korumalı posta kutusu oluşturma bu okuma iznini döndürür; sıradan korumasız oluşturma bunu atlar. |
data.pin_grant.mailbox_id |
integer | Koşullu okuma izninin bağlı olduğu posta kutusu kimliği. |
data.pin_grant.unlock_token |
string | Aynı sahibi kimlik bilgileriyle X-Mailbox-Unlock için opak okuma belirteci. Özel tutun ve bellekte saklayın; bir okuma izni silme yetkisi vermez. |
data.pin_grant.scope |
string | Koşullu oluşturma izni için okunan kapsam. |
data.pin_grant.idle_timeout_seconds |
integer | Okuma izni için izin verilen boşta kalma süresi, genellikle 3600 saniyedir. |
data.pin_grant.absolute_timeout_seconds |
integer | Okuma izninin maksimum süresi, genellikle 86400 saniyedir. |
data.pin_grant.expires_at |
string | Mevcut okuma izni süresi sonu ISO-8601 formatında. |
data.pin_grant.absolute_expires_at |
string | ISO-8601 formatında mutlak okuma izni süresi. Güvenlik değişiklikleri izni daha erken iptal edebilir. |
Mesajlar & Ekler
Gelen gelen kutularını getir, tam HTML/metin mesajlarını oku ve ekleri akış olarak gönder.
Posta Kutusu Mesajlarını Listele
Mevcut mesaj özetlerini ve posta kutusu meta verilerini alın. Standart gelen kutusu taramaları, en fazla 25 mesajlık yeni bir toplu sonuç döndürür; bu, sayfalı tam geçmiş uç noktası değildir. Tam gövdeler ve ekler için GET /messages/{messageId} kullanın.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
email
|
query | string | gerekli |
Okunacak mesajlar için sahip olunan posta kutusunun tam e-posta adresi. Sorgu değerini URL kodlayın; artı işaretini %2B olarak kodlayın.
|
X-Mailbox-Unlock
|
header | string | isteğe bağlı |
Başlık, yalnızca korumalı posta kutuları: bir okuma unlock_token kullanın. İlk olarak PIN ve scope=read'i PIN kilit açma URL'sine POST edin. Normal Bearer kimlik doğrulamanızı koruyun. <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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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:53",
"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:53+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:53+00:00",
"message_count_synced_at": "2026-11-19T02:17:53+00:00"
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
mailbox |
string | İstenen mesajların bulunduğu posta kutusu adresi. |
email_token |
string | Opak şifreli posta kutusu referansı; normal kimlik doğrulama hâlâ gereklidir. |
mailbox_provider |
string | Posta kutusu sağlayıcısı: standard, gmail_alias, veya outlook_alias. |
messages |
array | Mesaj özetleri. Boş bir gelen kutusu boş bir dizi döndürür; gövdesi ve ekleri için tek bir mesaj alın. |
expire_at |
string|null | ISO-8601 zaman damgası olarak geçerli son tarih, sınırsız posta kutusu için null. |
expires_in_seconds |
number|null | Hesaplandığında kalan negatif olmayan saniyeler; kesirli saniyeler mümkündür. Null sınırsız anlamına gelir, sıfır değil. |
mailbox_state |
string | Mevcut posta kutusu durumu: aktif, duraklatılmış, süresi dolmuş veya pasif. |
receiving_enabled |
boolean | Bu posta kutusunun şu anda gelen mesajları kabul edip etmediği. |
message_count |
integer | Bilinen toplam mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
unread_message_count |
integer | Bilinen okunmamış mesaj sayısı; son posta kutusu senkronizasyonunu yansıtabilir. |
last_message_received_at |
string|null | ISO-8601 formatında son bilinen alınan mesaj zamanı, mevcut olmadığında null. |
message_count_synced_at |
string|null | ISO-8601 formatında son mesaj sayısı senkronizasyon zamanı, senkronizasyondan önce ise null. |
mailbox_limit.limit |
integer | Bu sağlayıcı için aktif posta kutusu limiti; -1 sınırsız anlamına gelir. |
mailbox_limit.limit_label |
string | posta kutusu limiti için görüntüleme etiketi |
mailbox_limit.active_count |
integer | Bu sağlayıcı için aktif posta kutularının sayısı. |
mailbox_limit.paused_count |
integer | Bu sağlayıcı için duraklatılmış posta kutularının sayısı. |
mailbox_limit.paused_mailboxes |
array<string> | Adresler posta kutusu sınırı nedeniyle duraklatıldı. |
mailbox_limit.remaining |
integer | Kalan aktif posta kutusu slotları; -1 sınırsız anlamına gelir. Bu, API istek kotası değildir. |
mailbox_limit.remaining_label |
string | Kalan posta kutusu yuvaları için görüntü etiketi. |
mailbox_limit.reached |
boolean | Aktif posta kutusu limitine ulaşılıp ulaşılmadığı. |
mailbox_limit.blocked |
boolean | Etkin posta kutusu limitinin sıfır olup olmadığı. |
mailbox_limit.provider |
string|null | Posta kutusu limitinin uygulandığı sağlayıcı. |
messages[].id |
string | Tek mesaj, silme ve ek uç noktaları tarafından kullanılan opak mesaj kimliği. |
messages[].is_seen |
boolean | Mesajın okunmuş olarak işaretlenip işaretlenmediği. |
messages[].subject |
string | Mesaj konusu. |
messages[].from |
string | Gönderenin görünen adı veya adresi. |
messages[].from_email |
string | Gönderen e-posta adresi. |
messages[].receivedAt |
string | Uygulama saat diliminde alınan zaman, YYYY-MM-DD HH:mm:ss biçiminde. |
messages[].otp |
string|null | Mevcut ve izin verildiğinde tek seferlik kod tespit edildi; aksi takdirde null. |
messages[].otp_locked |
boolean | Algılanan tek kullanımlık kodun özellik izinleri tarafından gizlenip gizlenmediği. |
messages[].verification_link |
string|null | Mevcut ve izin verildiğinde doğrulama URL'si tespit edildi; aksi takdirde null. |
messages[].verification_link_locked |
boolean | Algılanan doğrulama bağlantısının özellik izinleri tarafından gizlenip gizlenmediği. |
messages[].from_name |
string|null | Outlook özet alanı: orijinal gönderici adı. Standart ve Gmail özetlerinde yok. |
messages[].snippet |
string|null | Outlook özet alanı: kısa mesaj önizlemesi. |
messages[].received_at |
string|null | Outlook özet alanı: ISO-8601 alınan zaman, bilindiğinde. |
messages[].has_attachments |
boolean | Outlook özet alanı: ek meta verilerinin mevcut olup olmadığı. İndirme kullanılabilirliği ayrı ayrı kontrol edilir. |
Tek Mesaj Al
Sahip olunan bir mesajı opak mesaj kimliğiyle alın. Gövde formatlarını ve ek meta verilerini döndürür. Gövde alanları mesaj formatına bağlıdır; Outlook aşağıda listelenen sağlayıcıya özgü alanları ekler.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
messageId
|
path | string | gerekli |
Mesaj listesinde döndürülen benzersiz mesaj kimliği.
|
X-Mailbox-Unlock
|
header | string | isteğe bağlı |
Başlık, yalnızca korumalı posta kutuları: bir okuma unlock_token kullanın. İlk olarak PIN ve scope=read'i PIN kilit açma URL'sine POST edin. Normal Bearer kimlik doğrulamanızı koruyun. <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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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:53",
"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"
}
]
}
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
data.id |
string | Opak mesaj kimliği. |
data.is_seen |
boolean | Mesaj okuma durumu. Okuma, mesajı görülmüş olarak işaretleyebilir; önbelleğe alınan veri daha önceki bir durumu yansıtabilir. |
data.subject |
string | Mesaj konusu. |
data.from |
string | Gönderenin görünen adı veya adresi. |
data.from_email |
string | Gönderen e-posta adresi. |
data.to |
string | Alıcı posta kutusu adresi. |
data.mailbox_provider |
string | Posta kutusu sağlayıcısı: standard, gmail_alias, veya outlook_alias. |
data.receivedAt |
string | Uygulama saat diliminde alınan zaman, YYYY-MM-DD HH:mm:ss biçiminde. |
data.html |
boolean | Mesajın HTML gövdesi olup olmadığı. |
data.html_content |
string | HTML gövdesi mevcut olduğunda. HTML içermeyen standart mesajlar bu alanı atlayabilir. Mesaj içeriğini güvensiz olarak ele alın. |
data.text_content |
string | Metin gövdesi mevcut olduğunda; Standart mesajlar bir pre öğesinde kaçış yapılmış metin içerebilir veya bu alanı atlayabilir. |
data.content |
string | Görüntüleme için tercih edilen gövde, mevcut olduğunda genellikle HTML. |
data.attachments |
array | Ek meta verileri, ya da boş bir dizi. İndirmeler normal kimlik doğrulaması ve geçerli PIN yetkilendirmesi gerektirir. |
data.attachments[].name |
string | İndirirken tek bir yol segmenti olarak URL kodlaması yapılacak dosya adı. |
data.attachments[].size |
integer | Ek boyutu bayt cinsinden. |
data.attachments[].url |
string | Kimliği doğrulanmış Kullanıcı API indirme URL'si, bir dosya adıyla ek dosyalara eklendi. Bir URL, yerel dosyanın mevcut olduğunu garanti etmez. |
data.attachments[].extension |
string | Standart/Gmail meta veri alanı: sağlandığında dosya uzantısı. |
data.attachments[].id |
string | Outlook meta veri alanı: sağlayıcı ek kimliği. |
data.attachments[].content_type |
string | Outlook meta veri alanı: MIME içerik türü. |
data.from_name |
string|null | Outlook detay alanı: orijinal gönderici adı. |
data.to_email |
string|null | Outlook detay alanı: orijinal alıcı adresi. |
data.received_at |
string|null | Outlook detay alanı: ISO-8601 alınan zaman. |
data.has_html |
boolean | Outlook detay alanı: bir HTML gövdesi var mı. |
Mesajı Sil
Tek bir sahip olunan iletiyi sil.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
messageId
|
path | string | gerekli |
Kalıcı olarak silmek için benzersiz mesaj kimliği dizesi.
|
X-Mailbox-Unlock
|
header | string | isteğe bağlı |
Başlık, yalnızca korumalı posta kutuları: tek kullanımlık silme unlock_token kullanın. İlk POST pin, scope=delete ve 423 yanıtı tarafından PIN kilidi açma URL'sine döndürülen action/target_id. Okuma token'ı silemez. <code>https://v1.tempmailg.com/api/mailboxes/{mailbox}/pin/unlock</code>
|
Idempotency-Key
|
header | string | isteğe bağlı |
PIN korumalı oluşturma veya silme için gereklidir: sabit 16 ila 128 karakter uzunluğunda bir anahtar. Aynı anahtarı kullanarak aynı isteği tekrarlayın, böylece yinelenen işi önleyin.
|
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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
200 OK • JSON{
"status": true,
"message": "Message was deleted successfully."
}
| Alan | Tür | Açıklama |
|---|---|---|
status |
boolean | İşlemin başarılı olup olmadığı. |
message |
string | Silme sonucu. Eksik bir kaynak HTTP 404 döndürür. |
Ek İndir
Sahip olunan bir mesajdan bir ek indirin.
| Parametre | Konum | Tür | Durum | Açıklama |
|---|---|---|---|---|
messageId
|
path | string | gerekli |
Dosyayı içeren mesajın kimliği.
|
filename
|
path | string | gerekli |
İndirilecek ekin dosya adı ve uzantısı.
|
X-Mailbox-Unlock
|
header | string | isteğe bağlı |
Başlık, yalnızca korumalı posta kutuları: bir okuma unlock_token kullanın. İlk olarak PIN ve scope=read'i PIN kilit açma URL'sine POST edin. Normal Bearer kimlik doğrulamanızı koruyun. <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
| Alan | Tür | Açıklama |
|---|---|---|
Content-Disposition |
header | Başarılı yanıt, istenen dosya adını indirir. |
body |
binary | Başarı durumunda dosya baytları, JSON değil. Hatalar, 2xx olmayan bir durum koduyla JSON döndürür. |
Hız Sınırları ve Kotalar
Kredi tüketmeden gerçek zamanlı istek bütçelerini, oran sınırlamalarını ve hesap kotalarını izleyin.
Hız Sınırı ve Kota
Mevcut oran sınırlamanızı ve kota durumunuzu API kullanımı tüketmeden kontrol edin. Bu uç nokta kota ücretsizdir ve aylık API kredilerini düşmez (kötüye kullanım koruma sınırı: 60 istek/dak).
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'
Sentetik veri kullanılarak örnek yanıt. Kimlikler, adresler, tokenlar, zaman damgaları, plan limitleri ve sayılar değişiklik gösterir. Örnek ömürler plan varsayılanınızı geçersiz kılmaz. Yanıt alanı açıklamaları, nullable ve sağlayıcıya özgü alanları tanımlar.
Örnek yanıt
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"
}
}
}
| Alan | Tür | Açıklama |
|---|---|---|
data.limit |
integer|string | Hesap istekleri-dakika başına sınırı. "unlimited" dizesi sınırsız bir dakikalık bütçeyi belirtir; bu aylık kota ile bağımsızdır. |
data.remaining |
integer|string | Kalan hesap dakikalık bütçe slotları, ya da "unlimited" dizesi. Pozitif bir değer, API kredilerinin kaldığını göstermez. |
data.reset |
integer | Hesap dakikalık penceresi için saniyeler, aylık kota sıfırlaması için değil. Devre dışı bırakılmış veya sınırsız dakikalık bütçeler, nominal 60 saniyelik bir değeri koruyabilir; bu, bekledikten sonra erişim garantisi vermez. |
data.plan |
string | Mevcut plan etiketi. Okunabilir plan adı, data.quota.plan_name içinde ayrı olarak sağlanır. |
data.quota.enabled |
boolean | Küresel ve plan/kredi API erişiminin etkin olup olmadığı. Bu, kalan kapasiteyi göstermez veya kullanıcı API anahtarını değiştirmez. |
data.quota.user_api_status |
boolean | Kullanıcının Kullanıcı API anahtarını etkinleştirip etkinleştirmediği. İşlemler bu anahtarın yanı sıra etkin erişim ve mevcut kapasiteyi de gerektirir. |
data.quota.plan_name |
string | Mevcut planın okunabilir adı. |
data.quota.period |
string | Uygulama saat dilimini kullanarak YYYY-MM formatında takvim-ay kullanım süresi; zorunlu olarak abonelik faturalama dönemi olmayabilir. |
data.quota.base_limit |
integer | Temel aylık plan kotası. -1 değeri sınırsız anlamına gelir. |
data.quota.extra_requests |
integer | Mevcut kullanım dönemi için ek aylık izin verildi; satın alınan kredilerden ayrı. |
data.quota.monthly_limit |
integer | Temel izin ve mevcut dönem ekstra istekleri. -1 değeri sınırsız anlamına gelir. Satın alınan krediler dahil değildir. |
data.quota.monthly_remaining |
integer|null | Kalan sınırlı aylık izin, ya da aylık kota sınırsız olduğunda null. Null sıfır olarak yorumlanmamalıdır. |
data.quota.used |
integer | Başarılı, mevcut kullanım dönemindeki sayılan API işlemleri, kredi kullanan işlemler dahil. Durum kontrolleri bu değeri artırmaz. |
data.quota.purchased_credits |
integer | Aktif plan bonus kredileri dahil olmak üzere mevcut kredi bakiyesi. Bonus krediler bu bakiyeye ikinci kez eklenmemelidir. |
data.quota.bonus_credits |
integer | Kredi bakiyesinin aktif plan-bonus kısmı; satın alınan_kredilerin bir ayrıntısı, ek kapasite değil. |
data.quota.direct_purchased_credits |
integer | Aktif plan-bonus kısmı hariç kredi bakiyesi. Bu değer bonus_credits ile toplandığında purchased_credits eder. |
data.quota.remaining |
integer|null | Aylık kalan izin, mevcut kredi bakiyesiyle birlikte, bonuslar iki kez sayılmadan. Null, sınırsız aylık kota anlamına gelir. Bireysel özellik izinleri ve diğer istek limitleri hâlâ geçerlidir. |
data.quota.unlimited |
boolean | Aylık kota sınırsız mı? Bu, hesabın dakika bütçesini veya diğer özellik limitlerini sınırsız yapmaz. |
data.quota.usage_percent |
integer | Gösterge paneli uyumlu, 0 ile 100 arasında yuvarlanmış yüzde: kullanılan, kullanılan artı kalan bölünerek, 100 ile çarpılır. Mevcut kredi kapasitesini içerir, bu yüzden yeniden doldurmak yüzdeyi azaltabilir. Sınırsız kota veya sıfır boyutlu havuz için 0'dır; dakikalık oran sınırlama yüzdesi veya bir erişim kararı değildir. |
data.quota.reset_at |
string | Bir sonraki takvim ayı kota sıfırlaması için saat dilimi ofseti içeren ISO-8601 zaman damgası. Bu, abonelik bitiş tarihi değildir ve aylık sıfırlama satın alınan kredileri yeniden doldurmaz. |
status |
string | Bu durum uç noktası için tam anlamıyla başarı. Diğer başarılı posta kutusu uç noktaları boolean true değerini kullanır. |
data.monthly_limit |
integer | İlgili data.quota alanının uyumluluk takma adı; bakiyeleri hesaplarken tekrar eklemeyin. |
data.monthly_remaining |
integer|null | İlgili data.quota alanının uyumluluk takma adı; bakiyeleri hesaplarken tekrar eklemeyin. |
data.purchased_credits |
integer | İlgili data.quota alanının uyumluluk takma adı; bakiyeleri hesaplarken tekrar eklemeyin. |
Posta Kutusu Webhook'ları (Gerçek Zamanlı Gönderme)
Yeni gelen meylleri kontrol etmek için tekrar tekrar REST API'sini (GET /messages) sorgulamaktan kaçının; yerine, yeni mesajları gerçek zamanlı olarak sunucunuz veya otomasyon akışınıza Webhook'lar aracılığıyla gönderin.
Desteklenen Webhook Olayları
Her webhook bir veya daha fazla olay türüne abone olabilir. Belirtilen tetikleyicilerden biri çalıştığında, endpoint'iniz bu olayı bildiren bir bildirim alır.
Seçilen posta kutusuna yeni bir mesaj ulaştığında gerçek zamanlı olarak gönderilir.
Geçici posta kutusu süresi dolduğunda ve webhook işleme duraklatıldığında gönderilir.
Plan kuralları kapsamında süresi dolmuş bir posta kutusu tekrar aktif olduğunda gönderilir.
Webhook ve posta kutusu silinmeden hemen önce gönderildi.
İstek Başlıkları & HMAC İmza Doğrulaması
Her webhook teslimatı özel güvenlik başlıklarını içerir. Gelen isteğin asıl olarak TempMailg tarafından gönderildiğini ve değiştirilmediğini doğrulamak için X-TempMailg-Signature başlığını kullanın.
| Başlık Adı | Örnek Değer | Açıklama |
|---|---|---|
User-Agent |
TempMailg-Webhooks/1.0 | Webhook teslim çalışanı için standart tanımlayıcı. |
X-TempMailg-Event |
email.received | Bu teslimatı tetikleyen olay türü. |
X-TempMailg-Event-Id |
e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c | Bu teslimat denemesine atanan benzersiz UUID. |
X-TempMailg-Timestamp |
1725192000 | İsteğin başlatıldığı zamanı gösteren Unix epoch zaman damgası. |
X-TempMailg-Signature |
sha256=d7a8fbb307d7809469ca933b02d82941... | Gizlinizi kullanarak {timestamp}.{raw_body} üzerinden hesaplanan HMAC-SHA256 imzası. |
X-TempMailg-Test |
false | Gösterge panelinizdeki "Send Test Ping" özelliği tarafından gönderildiğinde doğru. |
İmza, HMAC ile SHA256 kullanılarak aşağıdaki dizede hesaplanır:
hash_hmac('sha256', "${X-TempMailg-Timestamp}.${raw_request_body}", your_webhook_secret)
Örnek Olay Verisi (email.received)
HTTP POST isteği gövdesinde application/json olarak gönderildi.
{
"id": "e7b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"version": "1.0",
"event": "email.received",
"occurred_at": "2026-11-19T02:17:54+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:54+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"
}
}
Alıcı Uygulama Örnekleri
Webhooks almayı ve HMAC imzalarını güvenli bir şekilde doğrulamayı görmek için dilinizi seçin.
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]);
Desteklenen Platformlar ve Otomasyon Entegrasyonları
TempMailg Webhook'ları, standart HTTPS uç noktaları ve önde gelen kodsuz/otomasyon platformlarıyla kutudan çıkar çıkmaz çalışır:
Sık karşılaşılan hatalar ve sorun giderme
Kullanıcı API'sini entegre ederken görebileceğiniz en yaygın yanıt kodları bunlardır.
Geçersiz, eksik veya iptal edilmiş Bearer token.
Sahiplik, özellik izinleri, alan erişimi veya ek boyutu işlemi engelledi. Yanıt kodunu ve mesajı kontrol edin.
Kaynak, izin verilen hostta bulunamadı veya kullanıcıya ait değil.
İşlem anahtarı farklı ayrıntılarla yeniden kullanıldı, başka bir işlem bekliyor veya posta kutusu güvenliği değişti. Yeniden denemeden önce kodu inceleyin.
Posta kutusu süresiz veya etkin değil.
Geçersiz parametreler, izin verilmeyen ömür süresi, kullanılabilir olmayan takma ad kapasitesi, geçersiz PIN yapılandırması veya eksik/geçersiz Idempotency-Key işlemi engelledi.
Korunan bir posta kutusu geçerli kapsamlı X-Mailbox-Unlock token'ına ihtiyaç duyar. Silme için yanıttaki action ve target_id'yi kullanın. Kilitlenme veya kurtarma gereksinimleri, yeniden denemeden önce çözülmelidir.
Bir istek sınırı, devre dışı plan, tükenmiş kota veya bekleme süresi işlemi engelledi. Nedeni ve mevcut bütçe başlıklarını kontrol edin. Retry-After isteğe bağlıdır.
Sunucu işlemi tamamlayamadı. Korunan oluşturma veya silme işlemleri için, yeniden denediğinizde aynı isteği ve Idempotency-Key'i koruyun.
Koruma depolaması veya koordinasyonu doğrulanamadı. Belirtilen gecikmeden sonra yeniden deneyin. Bu yanıt bir başarısız ödeme değildir.
Hızlı kontrol listesi
- 401 Unauthorized - Bearer token eksik, yanlış, iptal edildi veya yanlış kopyalandı.
- 403 Forbidden - Geçerli plan şu anda kullanıcı API erişimine sahip değil.
- 404 Not Found - Kaynak bulunamadı veya geçersiz parametre.
- 410 Gone / Expired - Posta kutusu süresinin dolduğu veya artık etkin olmadığı.
- 429 Rate Limited - Yanıt nedenini ve bütçe başlıklarını kontrol edin. Retry-After yalnızca zaman sınırlamaları için geçerlidir; tükenmiş krediler veya devre dışı bırakılmış erişim bir hesap değişikliği gerektirebilir.
Önerilen sonraki adım
Giriş yaptıysanız, önce API Yönetim sayfasını açın ve dış uygulamanızı hata ayıklamadan önce anahtarınızın, kota durumunuzun, plan erişim durumunuzun ve tam User API Base URL'nin doğrulayınız.