API belgeleri

GPTMail API

GPTMail API'si ile HTTPS üzerinden X-API-Key başlığını kullanarak geçici gelen kutuları oluşturabilir, mesajları listeleyip okuyabilir ve e-postaları silebilirsiniz. Otomatik testler, CI/CD hatları ve QA iş akışları için uygundur.

API Key nasıl alınır

Buy API requests

Purchase API requests with GPTMail points. Earn points through daily check-ins and public domains, or buy points with LDC at a 1:1 rate.

Buy with points / add requests

Seçenek 2: Kendi alan adınızı ekleyin

Herkese açık alan adı MX doğrulamasını geçince: oturum açmadan gönderilmişse → API anahtarı (20000 istek); oturum açıkken gönderilmişse → 200 puan. Her alan adı yalnızca bir ödül alır. Önemli: bağlandıktan sonra bu alan adı son eki, sitedeki tüm kullanıcılar için herkese açık bir son ek olur; diğer kullanıcılar da altında posta kutusu adresleri oluşturabilir. Etkinleştirmeden sonra, bu alan adını hizmetimize yönlendiren MX kaydını silmeyin, değiştirmeyin veya düzenlemeyin. Aksi halde sonraki kontroller alan adını hatalı yapılandırılmış sayabilir. Sonraki bir kontrol MX’i geçersiz bulursa alan adı devre dışı bırakılır. MX 3 ardışık kontrol boyunca geçersiz kalırsa ilişkili API Key de devre dışı kalır. MX daha sonra yeniden geçerli olursa alan adı otomatik olarak yeniden etkinleştirilir.

Alan adları

Herkese açık test anahtarı

Test için aşağıda gösterilen ortak genel anahtarı X-API-Key başlığında gönderin. Bu anahtar her gün değişir ve tüm kullanıcılar arasında paylaşılan günlük 200.000 istek sınırına sahiptir.

Bugün kalan

Sıfırlanmasına

Genel anahtar için canlı kota yükleniyor…

Aşağıdaki API referansı, AI araçları, bilgi tabanları veya bir README için Markdown olarak kopyalanabilir.

Temel URL: https://mail.chatgpt.org.uk

AI
llms.txt

·

llms-full.txt

(Markdown)

Hızlı başlangıç

  • X-API-Key: YOUR_KEY en basit seçenektir. Hızlı testler için YOUR_KEY yerine yukarıda gösterilen günlük genel anahtarı kullanın.

  • Çoğu posta kutusu endpoint’i email parametresi gerektirir, örneğin ?email=demo@example.com.

  • GPTMail API yanıtları success, data ve error alanlarını içeren JSON kullanır; bir API anahtarı kullanıldığında ayrıca usage eklenir. Hız sınırı yanıtları dahil Cloudflare hataları bunun yerine HTML döndürebilir. JSON'u ayrıştırmadan önce HTTP durumunu ve Content-Type değerini kontrol edin.

  • Bu sitede halihazırda desteklenen bir alan adını biliyorsanız önce mail oluşturma endpoint’ini çağırmanız gerekmez. prefix@domain’i yerelde oluşturup posta kutusu API’lerini doğrudan çağırarak bir istekten tasarruf edersiniz.

Hız sınırları ve yeniden denemeler

  • GET ve POST /api/generate-email, kaynak IP başına 10 saniyede 30 isteklik ortak bir sınırı paylaşır. Bu, hem herkese açık hem de kişisel API anahtarları için geçerlidir. Aynı IP'nin arkasındaki farklı anahtarlar ve istemciler bu sınırı paylaşır.

  • Bu sınırın aşılması HTTP 429 döndürür ve e-posta oluşturmayı 10 saniye boyunca engeller. Yeniden denemeden önce Retry-After süresi kadar bekleyin. Bu başlık yoksa en az 10 saniye bekleyin, ardından giderek artan aralıklarla yeniden deneyin. Aynı IP'yi paylaşan istemcilerden eşzamanlı yeniden denemelerden kaçının.

  • Bu kural gelen kutusu listeleme veya tek tek e-postaları okuma işlemlerine uygulanmaz. API anahtarının günlük ve toplam kotaları bağımsız olarak geçerli olmaya devam eder. 10 saniye beklemek tükenmiş bir anahtar kotasını geri getirmez.

Temel endpoint’ler

POST / GET
/api/generate-email

Geçici bir gelen kutusu oluşturur. En basit rastgele akış için GET kullanın; prefix ve domain ile açık kontrol istediğinizde POST kullanın.

GET
/api/emails?email=...

Bir posta kutusundaki mailleri getirir.

GET
/api/email/{id}?email=...

Metin, HTML, ham başlıklar ve meta veriler dahil tek bir maili getirir.

DELETE
/api/email/{id}?email=...

ID ile tek bir maili siler.

DELETE
/api/emails/clear?email=...

Bir posta kutusundaki tüm mailleri siler.

GET
/api/stats

Site geneli istatistikleri okur.

Örnek akış

İki yaygın desen: hizmetin sizin için gelen kutusu oluşturmasına izin vermek veya sabit bir önek istemek. Halihazırda desteklenen bir alan adını biliyorsanız, posta kutusunu yerelde oluşturup doğrudan sorgulayabilirsiniz.

1) Rastgele geçici bir email adresi oluştur

curl 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Yanıt örneği
{
  "success": true,
  "data": {
    "email": "a3f9c2b1@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 1,
    "remaining_today": 199999,
    "total_limit": 200000,
    "total_usage": 1,
    "remaining_total": 199999
  }
}

2) Sabit önek ile oluştur (ör. demo@example.com)

curl -X POST 'https://mail.chatgpt.org.uk/api/generate-email' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: PUBLIC_API_KEY' \
  -d '{"prefix":"demo"}'
Yanıt örneği
{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 2,
    "remaining_today": 199998
  }
}

3) Gelen kutusundaki mailleri listele

Desteklenen bir alan adını zaten biliyorsanız 1. adımı atlayıp doğrudan sorgulayın.

curl 'https://mail.chatgpt.org.uk/api/emails?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Yanıt örneği
{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "e5a7f3...",
        "email_address": "demo@example.com",
        "from_address": "noreply@github.com",
        "subject": "Your code: 654321",
        "content": "Your verification code is 654321",
        "html_content": "...",
        "has_html": true,
        "timestamp": 1709654321,
        "created_at": "2024-03-05T12:18:41Z"
      }
    ],
    "count": 1
  }
}

4) Tek bir maili oku — düz metin, HTML gövde ve meta veriler dahil

EMAIL_ID değerini 3. adımda dönen bir id ile değiştirin. Gelen kutusu adresini de email olarak gönderin (silme ve ek indirme işlemlerinde de): böylece e-posta, ID ile aranmak yerine doğrudan kendi gelen kutusundan okunur. API anahtarı kullanıldığında email parametresi isteğe bağlıdır, ancak gönderilmesi aramayı hızlandırır.

curl 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Yanıt örneği
{
  "success": true,
  "data": {
    "id": "e5a7f3...",
    "email_address": "demo@example.com",
    "from_address": "noreply@github.com",
    "subject": "Your code: 654321",
    "content": "Your verification code is 654321",
    "html_content": "<p>Your code is 654321</p>",
    "has_html": true,
    "timestamp": 1709654321,
    "raw_size": 2048,
    "created_at": "2024-03-05T12:18:41Z"
  }
}

5) ID ile tek bir maili sil

API anahtarı kullanıldığında email parametresi isteğe bağlıdır, ancak gönderilmesi aramayı hızlandırır.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/email/EMAIL_ID?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Yanıt örneği
{
  "success": true,
  "data": {
    "message": "Email deleted"
  }
}

6) Tüm gelen kutusunu temizle — bu adres için tüm mailleri siler

Her çağrı bir grubu siler. Yanıtta "has_more": true olduğu sürece, false dönene kadar tekrar çağırın.

curl -X DELETE 'https://mail.chatgpt.org.uk/api/emails/clear?email=demo@example.com' \
  -H 'X-API-Key: PUBLIC_API_KEY'
Yanıt örneği
{
  "success": true,
  "data": {
    "message": "Deleted 3 emails",
    "count": 3,
    "has_more": false
  }
}

Yanıt yapısı

Başarılı yanıtlar genelde böyle görünür. API Key ile kimlik doğruluyorsanız usage içindeki kota bilgisine dikkat edin.

{
  "success": true,
  "data": {
    "email": "demo@example.com"
  },
  "usage": {
    "daily_limit": 200000,
    "used_today": 1,
    "remaining_today": 199999,
    "total_limit": 200000,
    "total_usage": 1,
    "remaining_total": 199999
  }
}

Genişletilmiş istatistikler

  • /api/statistics/24h 24 saatlik tek bir saatlik dağılım aralığı döndürür; daha eski aralıklar için offset=1,2,... kullanın.
  • /api/statistics/top-subjects en sık görülen e-posta konularını döndürür.
  • /api/statistics/top-domains en aktif alan adlarını döndürür.
  • /api/statistics/top-senders en aktif gönderenleri döndürür.
GPTMail