Geliştirici & Otomasyon API'si

Kutu oluşturmak için hesap gerekmez. Okuma, uzatma ve silme işlemleri için oluşturma yanıtındaki token zorunludur. Hız veya sıfır log garantisi verilmez.

API Base URL

https://gecici.email/api/v1

Okuma header: Authorization: Bearer <token>

Python ile token, OTP ve MCP akışını test edin

Bu örnek tek bir geçici kutu oluşturur; yanlış tokenın 403 ile reddedildiğini denetler, kendi kutusuna kurgusal mesaj ekler, REST ile kodu ve MCP ile mesajı okur. Son adımda oluşturduğu kutuyu siler. Python 3 standart kütüphanesi yeterlidir; npm veya PyPI paketi gerekmez.

qa-flow.py kaynağını indirip inceleyin. Örnek kendi oluşturduğu kutuda çalışır; mevcut kutularınıza dokunmaz.
Aşağıdaki komutla çalıştırın. Adres, token ve mesaj içeriği çıktıya yazılmaz; X-Gecici-Client: qa-test etiketi operasyonu test sayımlarına ayırır.
Başarıda created, wrong_token_denied, rest_otp_matched, mcp_message_read ve cleanup alanları true olmalıdır.

python3 qa-flow.py --run

Neyi doğrular? Token kontrolünü, simülasyon API'sini, kod ayıklamayı ve MCP okumasını. Dış SMTP teslimatını doğrulamaz; external_smtp_tested alanı false kalır. Gerçek uygulama testinde simülasyon adımını, sahibi olduğunuz test uygulamasının posta gönderimiyle değiştirin.

Hata ayıklama

403: token yanlış, kutu süresi dolmuş veya özel ad korumalı olabilir.
409: özel ad kullanımda; yeni bir ad veya rastgele kutu seçin.
408: OTP/link henüz yok. Toplam bekleme sınırı koyarak tekrar deneyin; diğer HTTP hatalarını bekleme gibi ele almayın.
MCP tools/call yanıtında HTTP 200 yeterli değildir; result.isError ve içerikteki timeout/found alanlarını kontrol edin. MCP beklemesi 5–45 saniyedir.
SSE yanıtı data satırındaki type alanını kullanır ve bağlantı yaklaşık 45 saniye sonra kapanır. Yerel EventSource Bearer başlığı ekleyemez; yetkili fetch veya sınırlı yoklama kullanın.

Bu akış 25 Ekim 2026 tarihinde kendi geçici kutumuzda sınandı. Aşağıdaki yanıtlar biçimi açıklayan kurgusal örneklerdir; başka platformlarda teslimat veya uyumluluk kanıtı değildir.

MCP bağlantısı ve araç rehberi →

Tarayıcı ajanınıza kutu araçları eklemek için test edilmiş browser-use Python örneğini ve sonuç açıklamalarını inceleyin.

POST/api/v1/inbox/generate

Yeni rastgele geçici e-posta kutusu oluşturur.

İSTEK GÖVDESİ (REQUEST JSON):

{
  "domain": "gecici.email"
}

ÖRNEK YANIT (RESPONSE):

{
  "success": true,
  "inbox": {
    "address": "swift_9812@gecici.email",
    "token": "a1b2c3d4...",
    "expiresAt": 1757271920000,
    "ttlSeconds": 3600
  }
}

POST/api/v1/inbox/custom

Özel kullanıcı adlı kutu oluşturur. Ad 4-32 ASCII karakter olmalı, en az bir rakam ve arada -, _ veya . içermelidir. Resmî/korumalı isimler ve bunların basit varyantları reddedilir.

İSTEK GÖVDESİ (REQUEST JSON):

{
  "prefix": "qa-flow-42",
  "domain": "gecici.email"
}

ÖRNEK YANIT (RESPONSE):

{
  "success": true,
  "inbox": {
    "address": "qa-flow-42@gecici.email",
    "token": "...",
    "expiresAt": 1757271920000,
    "ttlSeconds": 3600
  }
}

GET/api/v1/inbox/:address/otp

Kutu tokenu ile en son ayıklanmış OTP kodunu döner; henüz yoksa HTTP 408. İstemci sınırlı aralıklarla tekrar deneyebilir.

ÖRNEK YANIT (RESPONSE):

{
  "success": true,
  "otp": "893120",
  "actionType": "verification",
  "sender": {
    "name": "QA Fixture",
    "address": "qa@example.invalid"
  },
  "subject": "Fictional QA verification code: 893120"
}

GET/api/v1/inbox/:address/links

Kutu tokenu ile ayıklanmış doğrulama bağlantısını döner; bağlantıyı açmaz. Henüz yoksa HTTP 408.

ÖRNEK YANIT (RESPONSE):

{
  "success": true,
  "verificationLink": "https://example.com/verify?token=xyz999",
  "actionText": "Hesabımı Doğrula",
  "actionType": "verification"
}

GET/api/v1/inbox/:address/messages

Gelen kutusundaki tüm mesajları listeler.

ÖRNEK YANIT (RESPONSE):

{
  "success": true,
  "address": "swift_9812@gecici.email",
  "count": 1,
  "messages": [
    {
      "id": "abc123xyz",
      "from": { "name": "QA Fixture", "address": "qa@example.invalid" },
      "subject": "Güvenlik Uyarısı",
      "smartSummary": { "otpCode": "449120", "actionType": "verification" },
      "receivedAt": 1757271920000
    }
  ]
}

GET/api/v1/inbox/:address/stream

Bearer token gerektiren SSE akışı. Tarayıcı arayüzü bunun yerine yetkili yoklama kullanır.

ÖRNEK YANIT (RESPONSE):

data: {"type":"new_email","email":{...},"timestamp":1757271920000}

DELETE/api/v1/inbox/:address

Gelen kutusu ve e-postalarını SQLite veritabanından mantıksal olarak siler; fiziksel silme garantisi yoktur.

ÖRNEK YANIT (RESPONSE):

{
  "success": true,
  "message": "Gelen kutusu ve tüm e-postalar silindi"
}

Form doğrulamasını baştan sona test edin

Çalıştırılabilir Python uygulaması ve Chrome formu ile yanlış kodu, başarılı doğrulamayı, tekrar kullanım reddini ve kutu temizliğini kontrol edin.