Mailhavuzu REST API Dokümantasyonu
Otomasyon botlarınız, Python scriptleriniz, ZennoPoster ve BAS projeleriniz için 1.5s hızında mailleri JSON olarak sunan resmi geliştirici arayüzü.
Kimlik Doğrulama (Authentication)
Tüm API istekleri HTTP başlığında (Header) kişisel API anahtarınızı gerektirir. API anahtarınızı Müşteri Panelinizdeki "API Erişimi" sekmesinden tek tıkla üretebilirsiniz.
X-Api-Key: mh_live_a1b2c3d4e5f6...
Base URL: https://mailhavuzu.com
Mevcut tüm posta kutusu kategorilerini, anlık hazır stok adetlerini ve fiyatlarını döner.
curl -s -X GET "https://mailhavuzu.com/api/v1/stock" \
-H "X-Api-Key: YOUR_API_KEY"
[
{
"id": 1,
"category": "hotmail_fresh",
"display_name": "Hotmail Taze Posta Kutusu",
"display_domain": "@hotmail.com",
"lifetime": "1-5 Saat",
"price": 12.50,
"stock": 420
},
{
"id": 2,
"category": "outlook_trusted",
"display_name": "Outlook Dinlendirilmiş Kalıcı",
"display_domain": "@outlook.com",
"lifetime": "3-6 Ay",
"price": 28.00,
"stock": 85
}
]
Hesabınızın güncel kullanılabilir bakiyesini döner.
curl -s -X GET "https://mailhavuzu.com/api/v1/balance" \
-H "X-Api-Key: YOUR_API_KEY"
{
"balance": 250.00
}
Bakiyenizden düşerek seçtiğiniz kategoriden anında posta kutusu satın alır ve giriş bilgilerini teslim eder.
| Parametre | Tip | Açıklama |
|---|---|---|
id veya category |
Integer / String | Ürünün ID numarası (örn: 1) veya kategori kodu (örn: "hotmail_fresh") |
quantity |
Integer | Satın alınacak kutu adedi (minimum 1) |
curl -s -X POST "https://mailhavuzu.com/api/v1/buy" \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id": 1, "quantity": 1}'
{
"success": true,
"mailboxes": [
{
"id": 8412,
"email": "[email protected]",
"password": "SamplePassword123!",
"status": "active",
"created_at": "2026-11-16 10:20:00"
}
]
}
Hesabınıza ait posta kutularına gelen mesajları ve akıllı kod yakalayıcının çıkardığı onay kodunu döner. Parametre olarak email veya mailbox_id geçildiğinde anlık olarak Microsoft Graph API sorgulanır (1.5s hızında canlı kod çekimi).
| Parametre | Tip | Açıklama |
|---|---|---|
email |
String (Opsiyonel) | Yalnızca bu e-posta adresine gelen mailleri filtreler ve anlık canlı okuma tetikler. |
mailbox_id |
Integer (Opsiyonel) | Posta kutusunun ID numarası. |
limit |
Integer (Opsiyonel) | Dönecek mesaj adedi (Varsayılan: 50, Maks: 200) |
curl -s -X GET "https://mailhavuzu.com/api/v1/[email protected]" \
-H "X-Api-Key: YOUR_API_KEY"
[
{
"id": 10523,
"mailbox_id": 8412,
"email": "[email protected]",
"sender": "[email protected]",
"subject": "184920 is your Instagram code",
"extracted_code": "184920",
"snippet": "To confirm your account, enter this code...",
"received_at": "2026-11-16 10:21:15"
}
]
Kod Örnekleri (Python & Node.js)
import time
import requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-Api-Key": API_KEY}
BASE_URL = "https://mailhavuzu.com/api/v1"
# 1. 1 Adet Posta Kutusu Satin Al
res = requests.post(f"{BASE_URL}/buy", json={"id": 1, "quantity": 1}, headers=HEADERS).json()
mailbox = res["mailboxes"][0]
email = mailbox["email"]
print(f"Posta Kutusu Teslim Alindi: {email}")
# 2. Onay Maili / Kodu Gelene Kadar Bekle (Canli polling)
print("Doğrulama kodu bekleniyor...")
for _ in range(20):
time.sleep(3)
mails = requests.get(f"{BASE_URL}/mail?email={email}", headers=HEADERS).json()
if mails:
latest = mails[0]
code = latest.get("extracted_code")
print(f"⚡ Kod Geldi: {code} (Gonderici: {latest['sender']})")
break
const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://mailhavuzu.com/api/v1";
async function getStock() {
const res = await fetch(`${BASE_URL}/stock`, {
headers: { "X-Api-Key": API_KEY }
});
const data = await res.json();
console.log("Mevcut Stoklar:", data);
}
getStock();
ZennoPoster & Browser Automation Studio (BAS) Entegrasyonu
ZennoPoster veya BAS içerisinden HTTP GET/POST blokları ile Mailhavuzu API’sini saniyeler içinde bağlayabilirsiniz:
- HTTP İsteği Başlığı: <code>X-Api-Key: mh_live_...</code> ekleyin.
- Kayıt formunu doldurmadan önce <code>POST /api/v1/buy</code> ile yeni e-posta adresi alın.
- Formu gönderdikten sonra döngü içerisinde <code>GET /api/v1/mail?email={email}</code> çağırarak <code>extracted_code</code> alanını doğrudan formdaki SMS/Kod kutusuna yapıştırın.