YollaMail Geliştirici & Entegrasyon Dokümantasyonu

YollaMail, kurumsal toplu e-posta gönderim operasyonlarınızı hem kullanıcı dostu web arayüzünden hem de REST API üzerinden yönetmenizi sağlayan yüksek performanslı bir altyapıdır.

1. Sistem ve Canlı Altyapı Bilgileri

Sunucunuz şu anda bağımsız dedicated sunucu üzerinde tam yetkili olarak çalışmaktadır.

2. Gönderim Kanalları & Kullanım Kolaylığı

Sistemde iki farklı yönetim ve gönderim noktası bulunur:

3. REST API Entegrasyonu

Müşterileriniz veya bayileriniz kendi web sitelerinden (PHP, Python, Node.js, C#, WordPress vs.) doğrudan mail gönderebilir.

Yetkilendirme (Authentication)

Her bayiye veya müşteriye özel bir API Key atanır. İstek yaparken bu anahtar Header olarak gönderilmelidir:

X-API-Key: yolla_live_a1b2c3d4e5f6...

Gönderim Endpoint: POST /api/v1/send

URL: https://mail.yollamail.com/api/v1/send

JSON İstek Gövdesi:

{
  "to": ["alici1@gmail.com", "alici2@hotmail.com"],
  "from_name": "Şirketiniz",
  "from_email": "kampanya@yollamail.com",
  "subject": "Hoş Geldiniz İndirimi",
  "html": "<h1>Merhaba!</h1><p>Özel indirim kodunuz: YOLLA2026</p>"
}

Başarılı Yanıt (HTTP 200):

{
  "success": true,
  "job_id": 42,
  "message": "2 adet e-posta gönderim kuyruğuna alındı.",
  "recipients_count": 2,
  "remaining_quota": 99998
}

4. Hazır Kod Örnekleri

PHP Entegrasyonu (cURL)

<?php
$data = [
    "to" => ["musteri@gmail.com"],
    "from_name" => "Firma Adınız",
    "from_email" => "info@yollamail.com",
    "subject" => "Sipariş Onayınız",
    "html" => "<b>Siparişiniz başarıyla alınmıştır.</b>"
];

$ch = curl_init("https://mail.yollamail.com/api/v1/send");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "X-API-Key: yolla_live_ANAHTARINIZ"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python Entegrasyonu

import requests

headers = {
    "Content-Type": "application/json",
    "X-API-Key": "yolla_live_ANAHTARINIZ"
}
payload = {
    "to": ["musteri@gmail.com"],
    "from_name": "Firma Adınız",
    "from_email": "info@yollamail.com",
    "subject": "Python ile Gönderim Testi",
    "html": "<p>YollaMail API üzerinden sorunsuz gönderildi.</p>"
}

r = requests.post("https://mail.yollamail.com/api/v1/send", json=payload, headers=headers)
print(r.json())

Node.js / Express Entegrasyonu

const response = await fetch("https://mail.yollamail.com/api/v1/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "yolla_live_ANAHTARINIZ"
  },
  body: JSON.stringify({
    to: ["musteri@gmail.com"],
    from_name: "YollaMail",
    from_email: "info@yollamail.com",
    subject: "Node.js Test E-Postası",
    html: "<p>Hızlı ve güvenilir teslimat.</p>"
  })
});

const result = await response.json();
console.log(result);

5. Bayilik (Reseller) ve Müşteri Açma

Yönetici olarak Operasyon Portalı üzerinden:

• Yeni Müşteri veya Bayi oluşturabilirsiniz.
• Her kullanıcıya dilediğiniz miktarda gönderim kotası (örn. 250.000 adet) tanımlayabilirsiniz.
• Sistem otomatik olarak benzersiz X-API-Key üretir. Bu anahtarı müşterinize ilettiğinizde, müşteri kendi paneline bağlayıp kotası kadar mail atabilir.

6. İletişim ve Doğrudan Destek

Teknik entegrasyon, özel IP tahsisi veya altyapı sorularınız için 7/24 doğrudan iletişim kanallarımız: