Zarfena REST API v1.0 • Global Uptime %99.99

Modern Uygulamalarınız İçin
Dokümantasyon & API Entegrasyonu

Geliştiriciler ve sistem mimarları için tasarlandı. Transactional e-posta gönderimi, dinamik posta kutusu provizyonu ve webhook olay akışlarını tek bir RESTful arayüz ile dakikalar içinde sistemlerinize bağlayın.

API Anahtarı Oluştur

Geliştirici Konsolu & Çoklu Dil

Favori Dilinizle Saniyeler İçinde Başlayın

Aşağıdaki örneklerden birini seçin, kodunuzu kopyalayın veya doğrudan canlı simülasyonu çalıştırarak sunucu yanıtını izleyin.

curl -X POST https://zarfena.com/v1/api/mail/send \
  -H "Authorization: Bearer zarf_live_801e74a89fb2..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "bildirim@alanadiniz.com",
    "from_name": "Şirketim Bildirim",
    "to": ["ahmet@musteri.com"],
    "subject": "Sipariş Onayı #9201",
    "html": "<p>Merhaba Ahmet Bey, siparişiniz başarıyla alındı.</p>",
    "text": "Merhaba Ahmet Bey, siparişiniz başarıyla alındı."
  }'

Yetki Kapsamı: mail:sendProtokol: HTTPS / TLS 1.3

Sunucu Yanıtı (JSON Response)HTTP 201 Created

38 ms

İçerik Türü: application/jsonZarfena Cloud Gateway v1.4

API Referansı & Şemalar

Tüm Endpoint ve Parametre Detayları

Zarfena API üzerinde yer alan parametreleri, veri tiplerini ve zorunlu alanları inceleyin.

Endpoint Listesi

POST/v1/api/mail/send

Transactional E-Posta Gönder

Uygulamanızdan sipariş onayı, parola sıfırlama, fatura veya pazarlama bildirimlerini yüksek teslimat oranı ve anlık TLS 1.3 şifrelemesiyle gönderir.

Gerekli Yetki: mail:send

İstek Parametreleri (Body / Query Parameters)

Parametre	Tip	Durum	Açıklama	Örnek Değer
from	string	Zorunlu	Gönderen e-posta adresi (alan adınıza ait olmalıdır)	bildirim@alanadiniz.com
from_name	string	İsteğe Bağlı	E-postada görünecek gönderici adı	Zarfena Kurumsal
to	string[]	Zorunlu	Alıcı e-posta adresleri listesi (1-100 alıcı)	["ahmet@musteri.com"]
subject	string	Zorunlu	E-posta konu başlığı	Siparişiniz Kargoya Verildi #49102
html	string	İsteğe Bağlı	Zengin HTML e-posta gövdesi	<h1>Tebrikler!</h1><p>Siparişiniz yolda.</p>
text	string	İsteğe Bağlı	Düz metin alternatif içerik	Tebrikler! Siparişiniz yolda.
reply_to	string	İsteğe Bağlı	Yanıtların iletileceği e-posta adresi	destek@alanadiniz.com

Event-Driven Architecture

Gerçek Zamanlı Webhook Olay Akışı

E-postalarınız teslim edildiğinde, alıcı tarafından okunduğunda veya spam geri bildirimi alındığında sunucunuza anında HTTP POST webhook ile bildirim gönderilir.

email.deliveredTESLİMAT

Başarıyla Teslim Edildi

Alıcı posta sunucusu SMTP 250 OK yanıtı verdi ve ileti teslim alındı.

email.openedETKİLEŞİM

İleti Görüntülendi

Alıcı e-posta içeriğini açtığında piksel tetiklendi ve olay kaydedildi.

email.bouncedGERİ DÖNÜŞ

İleti Geri Döndü (Bounce)

Alıcı adresi geçersiz veya posta kutusu dolu olduğunda sistem sizi uyarır.

mailbox.createdPROVİZYON

Yeni Posta Kutusu Açıldı

API veya admin panelinden yeni hesap tanımlandığında tetiklenir.

Örnek Webhook Payload (POST /webhook/zarfena)X-Zarfena-Signature: sha256=9f8a10b...

{
  "event": "email.delivered",
  "timestamp": "2026-10-19T11:45:02.481Z",
  "data": {
    "message_id": "msg_9f81a4e0c9_20261019",
    "recipient": "ahmet@musteri.com",
    "subject": "Sipariş Onayı #9201",
    "smtp_response": "250 2.0.0 OK 1729338302 d18si9281014pld.41",
    "attempt": 1,
    "ip_address": "92.249.63.52"
  }
}

Kurumsal Güvenlik & Mimari

Geliştiricilerin İhtiyaç Duyduğu Her Şey

İşletmenizin veri güvenliğini riske atmadan, kurumsal seviyede izolasyon ve hız avantajından faydalanın.

Granüler Yetkilendirme (Scopes)

Her uygulama için ayrı anahtar üretin. Örneğin yalnızca transactional e-posta gönderen web sitenize mail:send yetkisi tanımlayın; posta kutularını okuma yetkisi vermeyin.

IP Allowlist Güvenlik Duvarı

API anahtarınızın yalnızca sunucunuzun statik IP adreslerinden çağrılabilmesini sağlayın. Anahtar sızsa dahi yetkisiz IP adreslerinden gelen tüm istekler anında engellenir.

Sıfır Kesinti Anahtar Yenileme

Güvenlik politikalarınız gereği periyodik anahtar döndürme (secret rotation) işlemlerini Müşteri Portalından tek tıkla canlı sistemlerinizde kesinti olmadan gerçekleştirin.

Yüksek Verim & Akıllı Kuyruk

Kampanya ve toplu transactional gönderimlerde postfix & rspamd optimizasyonlu çok kanallı kuyruk mimarisiyle e-postalarınız gecikmeden alıcılara iletilir.

Popüler Çerçeve ve Dillerle Uyum

Next.js, Express, Django, Laravel, Symfony, Go Gin, Spring Boot veya doğrudan cURL ile hiçbir harici kütüphane yükleme zorunluluğu olmadan saf HTTP üzerinden çalışın.

Canlı İstek & Hata Günlükleri (Logs)

Gönderilen her isteğin HTTP durumu, yanıt süresi, alıcı durumu ve varsa yetki hataları Müşteri Portalında anlık filtrelenebilir loglar halinde sunulur.

Merak Edilenler

Geliştiriciler İçin Sıkça Sorulan Sorular

Müşteri Portalınıza giriş yaptıktan sonra sol menüdeki 'API Entegrasyonları' sekmesine giderek dilediğiniz izin kapsamlarında (scopes) ve IP kısıtlamalarıyla saniyeler içinde yeni API anahtarı üretebilirsiniz.

Hemen Başlayın

API Entegrasyonunuzu Bugün Tamamlayın

Zarfena Müşteri Portalı üzerinden anında bir API anahtarı üretin, sandbox veya canlı ortamda ilk e-postanızı dakikalar içinde gönderin.

Müşteri Portalına Git Teknik Satışla Görüşün

Modern Uygulamalarınız İçin Dokümantasyon & API Entegrasyonu