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.

İstekNe yapar
POST https://sendhaste.com/api/v1/emailsBir 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/sendersAnahtarın gönderebileceği adresleri listeler.
GET https://sendhaste.com/api/v1/openapi.jsonTü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

  1. Bir Kuruluş Süper Yöneticisi Ayarlar → API anahtarları sayfasını açar.
  2. 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.
  3. 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
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."
  }'
JavaScript (Node.js 18+)
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.

  1. Ş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.
  2. 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.
  3. Test gönder altında, nasıl göründüğünü görmek için birkaç değerle kendinize gönderin.
  4. Siteniz adla birlikte template, değerlerle birlikte params gönderir. Bir subject göndermezseniz şablonun konusu kullanılır.
curl
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önderirseniz params iç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ı

  1. 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.
  2. Ayarlar → API anahtarları bölümünde welcome olarak bağlayın ve adresinizden gönderen bir anahtar oluşturun.
  3. Anahtarı sitenizin ayarlarına koyun (örneğin SENDHASTE_API_KEY ortam değişkeni).
  4. Sitenizin yeni kullanıcıyı kaydettiği yerde isteği gönderin. Dilinizi seçin:
JavaScript (Node.js 18+)
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 },
  }),
});
PHP
$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);
Python
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:

JSON
{"data": [{"name": "welcome", "template_name": "Welcome", "subject": "Welcome, {{params.first_name|there}}!", "params": ["first_name", "verify_url"], "updated_at": "…", "scope": "domain", "for": "yourshop.com"}]}
AlanNe olduğu
nametemplate 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.
scopeKimin için bağlandığı: organization (alan adlarınızdaki tüm adresler), domain veya address.
forBağ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.

JSON
{"data": [{"address": "info@yourcompany.com"}, {"address": "noreply@yourcompany.com"}], "domains": [{"domain": "yourcompany.com"}]}
AlanNe olduğu
dataAnahtarı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ı.
domainsAnahtarı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

AlanGerekliNe olduğu
fromevetAdreslerinizden biri, isterseniz bir adla: Your Company <info@yourcompany.com>. SendHaste'te bir posta kutusu olmalıdır.
toevetBir adres veya adres listesi.
cc, bcchayırBir adres veya liste. Gizli alıcılar diğerlerine gösterilmez.
reply_tohayırYanıtların gideceği yer, Kimden adresi değilse.
subjectevet, template yoksaKonu satırı. Şablonla birlikte, şablonun konusunun yerine geçer.
texttext veya htmlDüz metin sürümü.
htmltext veya htmlHTML sürümü. Mümkünse ikisini de gönderin; yalnızca HTML varsa metin sürümü ondan oluşturulur.
attachmentshayırDosya listesi: filename, content, content_type. İçerik base64 ile kodlanmıştır.
templatehayırAyarlar → API anahtarları bölümünde bağlanmış bir e-postanın adı, ör. welcome. text ve html yerine.
paramshayı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.

DurumcodeNe yapmalı
401missing_api_key, invalid_api_keyAuthorization başlığını kontrol edin veya yeni bir anahtar oluşturun: bu anahtar iptal edildi.
403from_not_allowedAlan 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.
403api_disabledAPI üzerinden gönderim kuruluşunuz için açık değil: Destek sayfasından bize sorun.
400invalid_jsonBir JSON nesnesi gönderin.
415unsupported_media_typeContent-Type: application/json başlığını ayarlayın.
422invalid_field, mailbox_not_foundMesajın belirttiği alanı düzeltin veya önce Kimden posta kutusunu oluşturun.
404template_not_foundE-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.
413too_largeDaha küçük ekler gönderin.
429rate_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, 503send_failed, mailbox_not_readyGö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.