Yardım › Geliştiriciler için
Gönderme API'si
Kendi uygulamalarınızdan ve sitelerinizden, kendi adreslerinizden, kendi şablonlarınızla e-posta gönderin.
Uygulamalarınız, web siteleriniz ve betikleriniz tek bir HTTPS isteğiyle kuruluşunuzun adreslerinden e-posta gönderebilir: sipariş onayları, parola sıfırlamaları, iletişim formları, raporlar. E-postalar, SendHaste'te yazdıklarınızla aynı şekilde gönderilir.
| İstek | Ne yapar |
|---|---|
POST https://sendhaste.com/api/v1/emails | Bir e-posta gönderir: kendi içeriğiniz ya da değerlerle şablonlarınızdan biri. |
GET https://sendhaste.com/api/v1/templates | Şablonlara bağlı e-postaları ve her birinin kullandığı değerleri listeler. |
GET https://sendhaste.com/api/v1/senders | Anahtarın gönderebileceği adresleri listeler. |
GET https://sendhaste.com/api/v1/openapi.json | Tüm API, Postman, kod üreticileri ve diğer geliştirici araçları için bir OpenAPI 3.1 dosyası olarak. Anahtar gerekmez. |
1. API anahtarı oluşturun
- Bir Kuruluş Süper Yöneticisi Ayarlar → API anahtarları sayfasını açar.
- API anahtarı oluştur'a tıklayın, ona bir ad verin (ör. Web sitesi iletişim formu) ve Gönderen adres seçin: alan adlarınızdaki herhangi bir adres, tek bir alan adındaki herhangi bir adres veya yalnızca bir adres. Anahtar oluştur düğmesine tıklayın.
- Bir pencerede yeni anahtar, adı ve gönderdiği adresle birlikte gösterilir. Kopyala'ya, ardından Bitti'ye tıklayın. Anahtar
sh_ile başlar ve yalnızca bir kez gösterilir: kaybolursa iptal edin ve yenisini oluşturun.
Tek bir alan adından otomatik e-postalar için (sipariş onayları, uyarılar, raporlar) Ayarlar → Alan adları bölümünü açın, alan adını seçin ve yourdomain.com için API anahtarı oluştur düğmesine tıklayın: anahtar o alan adındaki herhangi bir adresten gönderebilir, başka hiçbirinden gönderemez. Önce gönderen adres için bir posta kutusu ekleyin, örneğin noreply@yourdomain.com. Yalnızca gönderen sınırlanır: e-postalar şirketinizdeki veya dışındaki herkese gidebilir.
Anahtarı sunucunuzda, bir ayarda veya ortam değişkeninde saklayın. Asla bir web sayfasına, mobil uygulamaya veya herkese açık bir kod deposuna koymayın: ona sahip olan herkes sizin adınıza e-posta gönderebilir. Sızarsa İptal et düğmesine tıklayın: hemen çalışmayı durdurur.
2. E-posta gönderin
https://sendhaste.com/api/v1/emails adresine, anahtar Authorization: Bearer sh_… başlığında ve e-posta JSON olarak, bir POST isteği gönderin:
curl https://sendhaste.com/api/v1/emails \
-H "Authorization: Bearer sh_your_key" \
-H "Content-Type: application/json" \
-d '{
"from": "Your Company <info@yourcompany.com>",
"to": ["client@example.com"],
"subject": "Your booking is confirmed",
"html": "<p>Thank you! See you on <b>Monday</b>.</p>",
"text": "Thank you! See you on Monday."
}'const res = await fetch("https://sendhaste.com/api/v1/emails", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SENDHASTE_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
from: "Your Company <info@yourcompany.com>",
to: "client@example.com",
subject: "Your booking is confirmed",
text: "Thank you! See you on Monday.",
}),
});
const result = await res.json(); // { id, from, to, recipients } or { error: { code, message } }3. Kendi şablonlarınızı gönderin
E-postayı kodunuzda yazmak yerine Şablonlar bölümünde bir kez tasarlayın ve sitenizin onu adıyla göndermesini sağlayın: hoş geldin e-postası, şifre sıfırlama, sipariş onayı. E-postayı sonra değiştirmek için şablonu düzenleyin veya adı başka bir şablona bağlayın; sitede hiçbir şey değişmez.
- Şablonlar bölümünde e-postayı tasarlayın. Sitenizden gelen bir değerin geleceği yere
{{params.first_name}}yazın; çizgiden sonra, değer yoksa ne kullanılacağı:{{params.first_name|there}}. Konuda, metinde ve düğme ile bağlantı adreslerinde çalışır. - Bir Org Super Admin Ayarlar → API anahtarları bölümünü açar, Sitelerinizin gönderdiği e-postalar altında Bir e-posta bağla'ya tıklar, bir E-posta adı yazar (ör.
welcome), Şablon seçer, Gönderen altında alan adlarınızdaki tüm adresleri, bir alan adını veya bir adresi seçer ve Bağla'ya tıklar. - Test gönder altında, nasıl göründüğünü görmek için birkaç değerle kendinize gönderin.
- Siteniz adla birlikte
template, değerlerle birlikteparamsgönderir. Birsubjectgöndermezseniz şablonun konusu kullanılır.
curl https://sendhaste.com/api/v1/emails \
-H "Authorization: Bearer sh_your_key" \
-H "Content-Type: application/json" \
-d '{
"from": "Your Shop <hello@yourshop.com>",
"to": "aysel@example.com",
"template": "welcome",
"params": { "first_name": "Aysel", "verify_url": "https://yourshop.com/verify?t=8f2c" }
}'- Hazır etiketler de çalışır:
{{first_name}},{{name}},{{company}},{{email}}.{{email}}ilk Kime adresidir; adlar gönderirsenizparamsiçinden, yoksa kişinin SendHaste'teki kişi kaydından gelir. - Değerler metin olarak eklenir: bir değerdeki HTML yazıldığı gibi görünür ve bir bağlantı değeri https://, http:// veya mailto: ile başlamalıdır.
- Yedeği olmayan eksik bir değer boş kalır; bu yüzden önce Test gönder ile deneyin.
Örnek: yeni kayıtlar için hoş geldin e-postası
- Welcome adlı bir şablon oluşturun: konusu
Welcome, {{params.first_name|there}}!, başlığıHi {{params.first_name|there}}ve{{params.verify_url}}adresine giden bir düğme. - Ayarlar → API anahtarları bölümünde
welcomeolarak bağlayın ve adresinizden gönderen bir anahtar oluşturun. - Anahtarı sitenizin ayarlarına koyun (örneğin
SENDHASTE_API_KEYortam değişkeni). - Sitenizin yeni kullanıcıyı kaydettiği yerde isteği gönderin. Dilinizi seçin:
await fetch("https://sendhaste.com/api/v1/emails", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SENDHASTE_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
from: "Your Shop <hello@yourshop.com>",
to: user.email,
template: "welcome",
params: { first_name: user.firstName, verify_url: verifyUrl },
}),
});$ch = curl_init("https://sendhaste.com/api/v1/emails");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SENDHASTE_API_KEY"), "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
"from" => "Your Shop <hello@yourshop.com>",
"to" => $user["email"],
"template" => "welcome",
"params" => ["first_name" => $user["first_name"], "verify_url" => $verifyUrl],
]),
]);
$result = json_decode(curl_exec($ch), true);import os, requests
requests.post(
"https://sendhaste.com/api/v1/emails",
headers={"Authorization": f"Bearer {os.environ['SENDHASTE_API_KEY']}"},
json={
"from": "Your Shop <hello@yourshop.com>",
"to": user.email,
"template": "welcome",
"params": {"first_name": user.first_name, "verify_url": verify_url},
},
timeout=10,
)Kullanıcı kaydedildikten sonra gönderin ve başarısız bir e-postanın kaydı durdurmasına izin vermeyin: hatayı kaydedip devam edin. Yanıttaki id, bize yazarsanız e-postayı bulmamıza yardımcı olur.
Şablonlarınızı listeleyin
Aynı anahtarla GET https://sendhaste.com/api/v1/templates, Ayarlar → API anahtarları bölümünde bağlanmış e-postaları ve her birinin kullandığı değerleri döndürür:
{"data": [{"name": "welcome", "template_name": "Welcome", "subject": "Welcome, {{params.first_name|there}}!", "params": ["first_name", "verify_url"], "updated_at": "…", "scope": "domain", "for": "yourshop.com"}]}| Alan | Ne olduğu |
|---|---|
name | template olarak ne gönderileceği. |
template_name | Şablonun SendHaste'teki adı. |
subject | Şablonun konusu, etiketleri henüz doldurulmamış. |
params | Şablonun kullandığı {{params.…}} adları: bunları params içinde gönderin. |
updated_at | Şablonun son değiştirildiği zaman. |
scope | Kimin için bağlandığı: organization (alan adlarınızdaki tüm adresler), domain veya address. |
for | Bağlandığı alan adı veya adres; tüm kuruluş için null. |
Kodunuz bunu başlangıçta veya bir testte çağırarak gönderdiği her e-postanın bağlı olduğunu ve tüm değerlerini aldığını kontrol edebilir.
Her e-posta alan adlarınızdaki tüm adresler, bir alan adı veya bir adres için bağlanır (Gönderen). Bir anahtar yalnızca gönderebildiği adresler için olan e-postaları listeler ve gönderir; böylece farklı alan adlarındaki siteler yalnızca kendi e-postalarını görür. Aynı ad her düzey için bağlanabilir: info@yourshop.com adresinden gönderilen e-posta o adresinkini, yoksa alan adınınkini, o da yoksa kuruluşunkini kullanır.
Adreslerinizi listeleyin
Aynı anahtarla GET https://sendhaste.com/api/v1/senders, gönderebileceği adresleri döndürür. Kimden adresini kodunuza yazmak yerine insanların seçmesini sağlamak için kullanın.
{"data": [{"address": "info@yourcompany.com"}, {"address": "noreply@yourcompany.com"}], "domains": [{"domain": "yourcompany.com"}]}| Alan | Ne olduğu |
|---|---|
data | Anahtarın gönderebileceği, posta kutusu olan tüm adresler: oluşturulduğu tek adres, alan adındaki tüm posta kutuları ya da alan adlarınızdaki tüm posta kutuları. |
domains | Anahtarın gönderebileceği alan adları. Tek bir adres için oluşturulan anahtarda boştur. |
Her Kimden adresinin SendHaste'te kendi posta kutusu olmalıdır. Bir posta kutusuna Ayrıca alır altında eklenen adres kullanılamaz, catchall@ da kullanılamaz. noreply@yourdomain.com gibi yalnızca gönderim için bir adres için Ayarlar → Alan adları bölümünde ona bir posta kutusu ekleyin; hemen data içinde görünür.
Alanlar
| Alan | Gerekli | Ne olduğu |
|---|---|---|
from | evet | Adreslerinizden biri, isterseniz bir adla: Your Company <info@yourcompany.com>. SendHaste'te bir posta kutusu olmalıdır. |
to | evet | Bir adres veya adres listesi. |
cc, bcc | hayır | Bir adres veya liste. Gizli alıcılar diğerlerine gösterilmez. |
reply_to | hayır | Yanıtların gideceği yer, Kimden adresi değilse. |
subject | evet, template yoksa | Konu satırı. Şablonla birlikte, şablonun konusunun yerine geçer. |
text | text veya html | Düz metin sürümü. |
html | text veya html | HTML sürümü. Mümkünse ikisini de gönderin; yalnızca HTML varsa metin sürümü ondan oluşturulur. |
attachments | hayır | Dosya listesi: filename, content, content_type. İçerik base64 ile kodlanmıştır. |
template | hayır | Ayarlar → API anahtarları bölümünde bağlanmış bir e-postanın adı, ör. welcome. text ve html yerine. |
params | hayır | Şablonla: {{params.…}} etiketlerinin değerleri, ör. {"first_name": "Aysel"}. En fazla 100 değer. |
Yanıt
E-posta gönderildiğinde: durum 200 ve {"id": "…", "from": "info@yourcompany.com", "to": ["client@example.com"], "recipients": 1, "status": "sent"}. Şablonla birlikte "template": "welcome" da.
Bugünkü günlük sınır tükenmiş ama yarınınkinde hâlâ yer varsa: durum 202 ve aynı alanlar, ek olarak "status": "queued", "deliverAfter": "2026-10-13T00:00:00Z". E-posta kabul edilir ve SendHaste onu saklar; deliverAfter zamanında (bir sonraki UTC gece yarısı) ya da ardından posta sunucusu kabul eder etmez gönderilir. 202 yanıtını başarı sayın ve e-postayı yeniden göndermeyin: yeniden denemek onu iki kez iletirdi.
Gönderilmediğinde: bir hata durumu ve {"error": {"code": "…", "message": "…"}}. code aynı kalır, böylece kodunuz bunu kontrol edebilir; mesaj neyin düzeltileceğini söyler.
| Durum | code | Ne yapmalı |
|---|---|---|
401 | missing_api_key, invalid_api_key | Authorization başlığını kontrol edin veya yeni bir anahtar oluşturun: bu anahtar iptal edildi. |
403 | from_not_allowed | Alan adlarınızdaki bir adresten (yalnızca alan catchall@ hariç) veya anahtarın sınırlandığı alan adından ya da tek adresten gönderin. |
403 | api_disabled | API üzerinden gönderim kuruluşunuz için açık değil: Destek sayfasından bize sorun. |
400 | invalid_json | Bir JSON nesnesi gönderin. |
415 | unsupported_media_type | Content-Type: application/json başlığını ayarlayın. |
422 | invalid_field, mailbox_not_found | Mesajın belirttiği alanı düzeltin veya önce Kimden posta kutusunu oluşturun. |
404 | template_not_found | E-posta adını Ayarlar → API anahtarları bölümünde From adresi, onun alan adı veya tüm kuruluş için bir şablona bağlayın ya da yazımını kontrol edin. |
413 | too_large | Daha küçük ekler gönderin. |
429 | rate_limited, daily_limit | Çok fazla istek: Retry-After başlığındaki saniye kadar bekleyin. Günlük sınır: bugünün ve yarının e-postaları da tükendi ya da posta sunucusunun bu adres için günlük sınırına ulaşıldı; Retry-After içindeki saniye kadar (UTC gece yarısına dek) bekleyin ve o zaman gönderin. |
502, 503 | send_failed, mailbox_not_ready | Gönderilmedi: birkaç dakika sonra tekrar deneyin. Devam ederse bize yazın. Posta sunucusunun kabul ettiği bir e-postaya, yanıtı geciktiğinde bile, bu yanıt asla verilmez. |
Sınırlar
- Anahtar başına dakikada en fazla 60 istek.
- E-posta başına en fazla 50 alıcı (to, cc ve bcc birlikte).
- E-posta başına en fazla 20 ek ve 25 MB.
- Her alan adı, SendHaste'ten de API'den de olsa, günde en fazla 300 e-posta gönderebilir; her posta kutusu ise alan adının sınırı kadar kişiye, bir Kuruluş Süper Yöneticisi alan adının sayfasında Her posta kutusunun günde e-posta gönderebileceği kişi sayısı ayarını yaptıysa daha azına e-posta gönderebilir. Yeni bağlanan bir alan adı daha düşük bir sınırla başlar; Ayarlar → Alan adları içindeki sayfası sınıra karşı Bugünkü e-postalar sayısını, Bugün reddedilen ve Yarına bekletilen sayılarını, sınır artarken de Isınma işaretini gösterir.
- Bugünkü sınırı aşan bir e-posta kaybolmaz: SendHaste onu saklar ve UTC gece yarısından sonra gönderir, yarının sınırından sayılır (durum
202). Posta sunucusu o sırada hâlâ kendi sınırındaysa, sunucu kabul eder etmez gönderilir. Yalnızca yarının sınırı da tükendiğinde reddedilir (daily_limit). - Böyle bekleyen e-postalar posta kutusunun kenar çubuğunda Zamanlanmış altında, Günlük gönderme sınırı nedeniyle bekletilenler başlığında listelenir; yapmanız gereken bir şey yok, kendiliğinden gönderilirler.
SMTP mi tercih ediyorsunuz? Birçok uygulama ve çatı bunun yerine SMTP ile bir posta kutusu üzerinden gönderebilir: sunucu ve bağlantı noktası için Outlook, Apple Mail ve telefon uygulamaları sayfasına bakın. Aynı günlük sınırlar geçerlidir.
Aradığınızı bulamadınız mı? Bize mesaj gönderin.