TempMail API Belgeleri

REST API v1 ve Webhook'lar

TempMailg Geliştirici API Belgeleri

Bu belgeyi kullanarak kişisel API anahtarınızı oluşturun, adanmış kullanıcı API hostunu bağlayın, posta kutusu mesajlarını okuyun, sahip olunan posta kutularını yönetin ve Temp Mail'i kendi uygulamalarınız veya otomasyonlarınızla entegre edin.

Taşıyıcı Token Kimlik Doğrulama Gerçek Zamanlı Webhook'lar Gmail ve Outlook Takma Adları JSON Yanıtları
Kullanıcı API Base URL HTTPS
İstek formatı API anahtarınızı yalnızca Yetkilendirme Taşıyıcı başlığında kullanın ve uç nokta URL'lerini temiz tutun.

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.

GET https://v1.tempmailg.com/api/domains?type={type}
#

İ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.

Parametreler 1
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ı
İzin verilen alanları al
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
            }
        ]
    }
}
Yanıt alanları
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ığı.
POST https://v1.tempmailg.com/api/emails
#

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.

Parametreler 8
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.
İsteğe bağlı gövde parametreleri: 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.
Posta kutusu oluştur
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"
    }
}
Yanıt alanları
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.
POST https://v1.tempmailg.com/api/emails/{email}/{username}/{domain}
#

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.

Parametreler 9
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>
{email}中的 mevcut sahip olunan posta kutusu e-postasını kullanın. İsteğe bağlı gövde parametresi: 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.
Sahip olunan posta kutusunu güncelle
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"
    }
}
Yanıt alanları
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.
DELETE https://v1.tempmailg.com/api/emails/{email}
#

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.

Parametreler 3
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.
Sahip olunan posta kutusunu sil
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."
}
Yanıt alanları
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.

POST https://v1.tempmailg.com/api/gmail-alias/emails
#

Gmail Takma Adı Oluştur

Kimliği doğrulanmış kullanıcıya ait yeni bir Gmail takma adı geçici posta kutusu oluşturun.

Parametreler 8
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.
Gmail Alias API izninin abonelik planınızda etkinleştirilmiş olması veya bir API Kredi paketiyle kilidinin açılması gerekir. İsteğe bağlı parametreler: 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.
Gmail takma ad posta kutusu oluştur
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"
    }
}
Yanıt alanları
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.
GET https://v1.tempmailg.com/api/outlook-alias/domains
#

Outlook Takma Ad Alanları

Posta kutusu oluşturma için mevcut aktif Outlook / Hotmail takma ad alanlarını getir.

Outlook Alias API izninin abonelik planınızda etkinleştirilmiş olmasını veya bir API Kredi paketi ile açılmış olmasını gerektirir. Planınızda belirli alan adı seçiminin kilidinin açılıp açılmadığını gösterir.
Outlook takma ad alanlarını al
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
            }
        ]
    }
}
Yanıt alanları
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.
POST https://v1.tempmailg.com/api/outlook-alias/emails
#

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.

Parametreler 7
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.
Outlook Alias API izninin abonelik planınızda etkinleştirilmiş olmasını veya bir API Kredi paketi ile açılmış olmasını gerektirir. İsteğe bağlı parametreler: 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.
Outlook takma ad posta kutusu oluştur
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"
    }
}
Yanıt alanları
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.

GET https://v1.tempmailg.com/api/messages?email={email}
#

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.

Parametreler 2
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>
E-posta hesabınıza ait olmalıdır. Standart ve Gmail özetleri OTP ve verification-link alanlarını içerir; Outlook ayrıca from_name, snippet, received_at ve has_attachments alanlarını da içerir. Sağlayıcı senkronizasyonu ve önbellekleme yeni mesajları ve sayımları geciktirebilir.
Posta kutusu iletileri oku
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"
}
Yanıt alanları
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.
GET https://v1.tempmailg.com/api/messages/{messageId}
#

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.

Parametreler 2
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>
Bir ileti oku
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"
            }
        ]
    }
}
Yanıt alanları
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ı.
DELETE https://v1.tempmailg.com/api/messages/{messageId}
#

Mesajı Sil

Tek bir sahip olunan iletiyi sil.

Parametreler 3
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.
Bir mesajı sil
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."
}
Yanıt alanları
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.
GET https://v1.tempmailg.com/api/messages/{messageId}/attachments/{filename}
#

Ek İndir

Sahip olunan bir mesajdan bir ek indirin.

Parametreler 3
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>
Başarılı yanıt dosya baytlarını döndürür, JSON döndürmez. Boyutu aşan dosyalar HTTP 403 döndürür; eksik veya kullanılamayan yerel dosyalar HTTP 404 döndürür. Dosya adını tek bir yol segmenti olarak URL kodlayın. Yalnızca ek meta verileri indirme kullanılabilirliğini garanti etmez.
Bir ek indir
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
İndirme davranışı Bu uç nokta, JSON gövdesi yerine istenen dosyayı doğrudan döndürür.
Yanıt alanları
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.

GET https://v1.tempmailg.com/api/rate-limit
#

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).

X-RateLimit-* belirtilen istek bütçesini açıklar; X-Quota-* mevcut olduğunda aylık ve satın alınan kapasiteyi açıklar. X-Mailbox-RateLimit-* ayrı posta kutusu oluşturma/güncelleme bütçesini rapor eder. Sadece posta kutusu reddi, posta kutusu kapsamını ve kendi yeniden deneme penceresini kullanır. Dakika sınırlı reddetmeler, kota bilgilerini atlayabilir. Retry-After yalnızca zamanlanmış bir yeniden deneme için eklenir; devre dışı bırakılmış erişim bir hesap değişikliği gerektirebilir. Bu başarılı durum yanıtında, data.limit, data.remaining ve data.reset hesap dakikalık bütçesini, harcanabilir kredileri değil, tanımlar. data.quota nesnesi aylık ödeneği, kredi bakiyelerini ve kullanımını açıklar. Mevcut data.monthly_limit, data.monthly_remaining ve data.purchased_credits alanları ilgili kota alanlarının takma adları olarak kalır. Başarılı bir durum kontrolü, başka bir API işlemini yetkilendirmez. İşlemler hâlâ etkin erişim, mevcut kota ve tüm geçerli limitler dahilinde onay gerektirir. Kota anlık görüntüsü, hâlihazırda devam eden bir istek tarafından ayrılmış kapasiteyi garanti etmez.
Hız sınırlaması durumunu kontrol et
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"
        }
    }
}
Yanıt alanları
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 PIN Koruması

Devam etmek için PIN'i girin. Posta kutunuz bu web sitesi oturumu boyunca geçerli olduğu sürece kilitsiz kalır.

Çerezleri kabul ediyor musunuz?

Çerezleri tarama deneyiminizi geliştirmek için kullanıyoruz. Bu siteyi kullanarak çerez politikamızı kabul etmiş olursunuz.

Daha fazla