GELİŞTİRİCİ DOKÜMANTASYONU

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.

// Tüm isteklerde gönderilmesi zorunlu HTTP Başlığı
X-Api-Key: mh_live_a1b2c3d4e5f6...

Base URL: https://mailhavuzu.com

GET /api/v1/stock

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"
Örnek Yanıt (200 OK):
[
  {
    "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
  }
]
GET /api/v1/balance

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"
Örnek Yanıt (200 OK):
{
  "balance": 250.00
}
POST /api/v1/buy

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}'
Örnek Yanıt (200 OK):
{
  "success": true,
  "mailboxes": [
    {
      "id": 8412,
      "email": "[email protected]",
      "password": "SamplePassword123!",
      "status": "active",
      "created_at": "2026-11-16 10:20:00"
    }
  ]
}
GET /api/v1/mail

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"
Örnek Yanıt (200 OK):
[
  {
    "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)

Python (requests) - Kutu Satın Al ve Onay Kodunu Bekle
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
Node.js / JavaScript (Fetch)
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:

  1. HTTP İsteği Başlığı: <code>X-Api-Key: mh_live_...</code> ekleyin.
  2. Kayıt formunu doldurmadan önce <code>POST /api/v1/buy</code> ile yeni e-posta adresi alın.
  3. 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.