ugiMail API DOCS

Geliştirici API Entegrasyon Kılavuzu

ugiMail Verification API, geçici e-posta oluşturma ve doğrulama süreçlerini kendi yazılımlarınıza entegre etmenizi sağlayan basit, güvenli ve yüksek hızlı bir HTTP tabanlı arayüzdür. Otomasyon araçları, otomatik üyelik test yazılımları ve diğer API entegrasyonu gerektiren tüm projelerinizde sorunsuzca kullanabilirsiniz.

API Temel (Base) URL

Tüm API isteklerinizi göndereceğiniz temel adres:

https://mail.ugilabs.com/public_api

Hız Sınırları (Rate Limit)

Sistem kaynaklarını korumak, aşırı yüklenmeleri engellemek ve genel güvenliği sağlamak amacıyla istemci IP adresine göre hız sınırları (Rate Limiting) uygulanmaktadır.

Yeni E-Posta Oluşturma 10 İstek / Saat

Aynı IP adresi saatte en fazla 10 yeni e-posta adresi üretebilir.

Gelen Kutusu ve Diğer İşlemler 60 İstek / Dakika

Inbox sorgulama, süre uzatma ve silme işlemleri dakikada en fazla 60 kez çağrılabilir.

Yanıt ve Hata Kodları

HTTP Kodu Anlamı Açıklama
200 OK Başarılı İşlem başarıyla tamamlandı. Yanıt JSON gövdesi içerisindedir.
400 Bad Request Geçersiz Parametre Gerekli parametreler eksik veya e-posta adresi biçimi hatalı.
404 Not Found Bulunamadı Sorgulanan e-posta adresi aktif listesinde kayıtlı değil.
410 Gone Süresi Dolmuş E-posta adresi aktif olmuş fakat 5 dakikalık geçerlilik süresi tükenmiş.
429 Too Many Requests Hız Limiti Aşıldı Dakikalık veya saatlik hız limiti sınırlarına takıldınız. İstek engellendi.
500 Internal Error Sunucu Hatası Sunucu kaynaklı veya sunucumuzla olan bağlantı nedeniyle oluşan beklenmedik hata.

API Uç Noktaları (Endpoints)

GET ?action=generate&prefix={prefix} E-Posta Oluştur

Geçici bir e-posta adresi üretir. Eğer prefix parametresi gönderilirse (sadece alfa-numerik karakterler), ön ek olarak kullanılır (Örn: prefix-xxxx@ugilabs.com). 10 dakikalık geçerlilik süresiyle sisteme kaydedilir.

Opsiyonel Parametreler
Parametre Tür Gerekli mi? Açıklama
prefix String Hayır Oluşturulacak e-postanın başına eklenecek özel ön ek.
Başarılı İstek Yanıtı
{"success":true,"email":"prefix-k8m3n8pq@ugilabs.com","expires_at":1783849200,"expires_in":600,"delete_token":"9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d"}
GET ?action=inbox&email={email} Gelen Kutusu, OTP, Doğrulama Linki ve Ek Ayrıştırma

Belirtilen e-posta adresine gelen son 30 e-postayı sorgular. Mesajlarda bulunan Discord onay tokenlarını, genel tek kullanımlık onay kodlarını (otp), genel doğrulama bağlantılarını (verification_url) ve ek dosyaları (attachments) otomatik ayrıştırıp döner.

Gerekli Parametreler
Parametre Tür Gerekli mi? Açıklama
email String Evet Daha önce sistemde oluşturulmuş aktif e-posta adresi.
Başarılı İstek Yanıtı
{"success":true,"messages":[{"id":4,"subject":"Hesap Onay Kodu","from":"Servis Adi ","date":"12.07.2026 01:45","body":"...","htmlBody":"...","token":"829104","otp":"829104","verification_url":"https://site.com/verify?code=829104","attachments":[{"id":"d1e2f3g4","filename":"fatura.pdf","size":45120,"download_url":"http://site.com/download?email=...&file_id=d1e2f3g4"}]}]}
GET ?action=extend&email={email} Süreyi Uzat (+5 Dakika)

Sorgulanan e-posta adresinin geçerlilik süresini her çağrıda 5 dakika (300 saniye) daha uzatır. Bu işlem, e-postanın süresi dolmadan önce yapılmalıdır.

Başarılı İstek Yanıtı
{"success":true,"email":"k8m3n8pq@ugilabs.com","expires_at":1783849500}
GET/POST ?action=delete&email={email}&token={delete_token} Kutuyu Kapat ve Temizle

E-posta adresinin aktif listesindeki kaydını siler ve bu adrese gönderilmiş olan tüm e-postaları sunucumuzdan kalıcı olarak kaldırır.

Başarılı İstek Yanıtı
{"success":true,"message":"E-posta adresi ve mailler kalici olarak silindi","deleted_mails_count":2}

Entegrasyon Kod Şablonları

1. E-Posta Adresi Oluşturma
curl "https://mail.ugilabs.com/public_api?action=generate"
2. Gelen Kutusu Sorgulama
curl "https://mail.ugilabs.com/public_api?action=inbox&email=test-xxxx@ugilabs.com"
3. Geçerlilik Süresini Uzatma
curl "https://mail.ugilabs.com/public_api?action=extend&email=test-xxxx@ugilabs.com"
4. E-Posta Kutusunu Kapatma ve Silme
curl "https://mail.ugilabs.com/public_api?action=delete&email=test-xxxx@ugilabs.com&token=DELETE_TOKEN"

API Kullanım ve Entegrasyon Kılavuzu

Geçici e-posta servisinin entegrasyonu, yazılım ve bot projelerinde doğrulama işlemlerini tamamen otomatik hale getirmek için tasarlanmıştır. Bu bölüm, servisi nerede, nasıl ve hangi pratik adımlarla kullanacağınızı detaylandırır.

Nerede Kullanılır? (Kullanım Alanları)

Discord ve Telegram Bot Kayıtları Botlarınızın veya kullanıcılarınızın hesap doğrulama adımlarını otomatik tamamlamak, e-posta onayını saniyeler içinde geçmek için kullanılır.
Otomatik Üyelik ve Form Testleri Web sitelerinizde veya uygulamalarınızda üyelik kayıt akışını, OTP onay ekranlarını ve e-posta doğrulama döngülerini otomatik test etmek için kullanılır.
Sosyal Medya Hesap Yönetimi Çoklu hesap açma süreçlerinde, her hesap için manuel e-posta kutusu oluşturma veya onay kodunu okuma adımlarını ortadan kaldırarak tam otomasyon sağlar.
API Entegrasyon Deneyleri E-posta alıcı servislerini mocklamak (taklit etmek) ve gelen e-posta içeriklerini programatik olarak doğrulamak istediğiniz tüm yazılım projelerinde kullanılır.

Nasıl Kullanılır? (Temel Kullanım Adımları)

1
E-Posta Adresi Talep Edin ?action=generate ucuna istek atarak anlık bir e-posta adresi alın. Dilerseniz prefix ekleyerek özelleştirin.
2
Hedef Platformda Kullanın Aldığınız e-posta adresini kayıt olacağınız veya e-posta doğrulaması isteyeceğiniz forma otomatik olarak gönderin.
3
Gelen Kutusunu Sorgulayın ?action=inbox&email=email_adresi adresi üzerinden gelen kutusunu belirli aralıklarla (örneğin 5 saniyede bir) sorgulayın.
4
Doğrulama Verisini Ayıklayın Gelen kutusu yanıtındaki hazır ayıklanmış otp (tek kullanımlık şifre) veya verification_url (doğrulama linki) değerlerini doğrudan kullanın.
5
Temizlik Yapın İşleminiz bittiğinde ?action=delete&email=email_adresi isteği göndererek e-posta adresini ve tüm ilişkili verileri kalıcı olarak silin.

Örnek Entegrasyon Senaryosu

Discord Kayıt Botu Akış Örneği
Aşama 1 Bot, API üzerinden test-bot-abc@ugilabs.com adresini oluşturur.
Aşama 2 Discord kayıt sayfasındaki e-posta alanına bu adresi girer ve gönderir.
Aşama 3 Bot, inbox API ucunu sorgular. Discord'dan gelen e-posta yakalandığında, API yanıtındaki verification_url değerini alır.
Aşama 4 Bot, bu verification_url adresine HTTP isteği göndererek e-posta doğrulama aşamasını başarıyla tamamlar.
Aşama 5 İşlem bittiğinde delete API ucu çağrılarak e-posta kutusu kapatılır ve tüm veriler sunucudan temizlenir.