REST & SSE API v1

Geliştirici & Otomasyon API'si

API anahtarı gerekmeden, saniyede yüzlerce istek yapabileceğiniz hızlı ve bağımsız uç noktalar.

Sponsor / Reklam Alanı (Sıfır CLS)
Google AdSense & Doğrudan Sponsorluk Entegrasyonuna Hazır
API Base URL
https://gecici.email/api/v1
Header: Content-Type: application/json
POST/api/v1/inbox/generate

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

Request Body (JSON):
{
  "domain": "gecici.email"
}
Response Örneği:
{
  "success": true,
  "inbox": {
    "address": "swift_9812@gecici.email",
    "token": "a1b2c3d4...",
    "expiresAt": 1757271920000,
    "ttlSeconds": 3600
  }
}
POST/api/v1/inbox/custom

Özel kullanıcı adlı geçici e-posta kutusu oluşturur.

Request Body (JSON):
{
  "prefix": "ahmet_test",
  "domain": "gecici.email"
}
Response Örneği:
{
  "success": true,
  "inbox": {
    "address": "ahmet_test@gecici.email",
    "token": "...",
    "expiresAt": 1757271920000,
    "ttlSeconds": 3600
  }
}
GET/api/v1/inbox/:address/otp

Yapay Zeka (AI) Uç Noktası: Yeni e-posta gelene kadar bekler ve 6 haneli OTP doğrulama kodunu döner.

Query Params: ?timeout=30000 (milisaniye cinsinden maksimum bekleme süresi)
Response Örneği:
{
  "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

Yapay Zeka (AI) Uç Noktası: Aktivasyon / Sihirli giriş linkini doğrudan ayıklar.

Query Params: ?timeout=30000
Response Örneği:
{
  "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.

Response Örneği:
{
  "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

Server-Sent Events (SSE) Gerçek Zamanlı Akış. Yeni mail düştüğü anda milisaniyelik event iletir.

Response Örneği:
event: new_email
data: {"type":"new_email","email":{...},"timestamp":1757271920000}
DELETE/api/v1/inbox/:address

Gelen kutusunu ve tüm e-postaları sunucu belleğinden anında kalıcı olarak siler.

Response Örneği:
{
  "success": true,
  "message": "Gelen kutusu ve tüm e-postalar silindi"
}