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.

Sponsor / Reklam Alanı (Sıfır CLS)

Google AdSense & Doğrudan Sponsorluk Entegrasyonuna Hazır

API Base URL

https://gecici.email/api/v1

Okuma header: Authorization: Bearer <token>

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": "ahmet-test-1",
  "domain": "gecici.email"
}

ÖRNEK YANIT (RESPONSE):

{
  "success": true,
  "inbox": {
    "address": "ahmet-test-1@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": "GitHub Security",
    "address": "noreply@github.com"
  },
  "subject": "Your GitHub 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": "Google", "address": "no-reply@google.com" },
      "subject": "Güvenlik Uyarısı",
      "smartSummary": { "otpCode": "449120", "actionType": "security_alert" },
      "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):

event: new_email
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"
}