REST API · Ücretsiz Erişim

SMS API ile Yazılımınıza SMS Entegrasyonu

WooCommerce'den WHMCS'e, özel yazılımdan mobil uygulamaya ve CRM sistemlerine — birkaç satır kodla SMS gönderimini sisteminize entegre edin. API erişimi tüm paketlerde ücretsizdir.

VatanSMS SMS API, REST mimarisinde çalışır ve PHP, Python, Java, .NET gibi tüm yaygın dilleri destekler. WooCommerce, WordPress, OpenCart, Joomla, Zoho CRM ve WHMCS için hazır entegrasyon eklentileri mevcuttur. API erişimi tüm SMS paketlerinde ücretsizdir.

send_sms.py
import requests

response = requests.post(
"https://api.vatansms.com/v1/sms",
json={
"to": "905XXXXXXXXX",
"message": "Merhaba {isim}!",
"sender": "FirmaAdi""""
},
headers={"Authorization": "Bearer API_KEY"}
)
# {"message_id": "abc123", "status": "queued"}
REST API
Ücretsiz API Erişimi
Webhook Desteği
6 Hazır Eklenti
Kod Örnekleri

Tercih Ettiğiniz Dilde SMS Gönderin

HTTP isteği yapabilen her dil VatanSMS API ile çalışır. Aşağıdaki örnekleri kopyala-yapıştır ile kullanabilirsiniz. API anahtarınızı YOUR_API_KEY alanına yazmanız yeterlidir.

// PHP — cURL ile SMS gönderimi"""
$data = [
'to' => '905XXXXXXXXX',
'message' => 'Merhaba! Kampanyamız başladı.',
'sender' => 'FirmaAdi',
];

$ch = curl_init('https://api.vatansms.com/v1/sms');
curl_setopt_array($ch, [
CURLOPT_POST         => true,
CURLOPT_POSTFIELDS   => json_encode($data),
CURLOPT_HTTPHEADER   => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
],
CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);
// $response['message_id'] => "abc123"
# Python — requests kütüphanesi ile SMS gönderimi"""
import requests

API_KEY = "your_api_key""""

response = requests.post(
"https://api.vatansms.com/v1/sms",
json={
"to": "905XXXXXXXXX",
"message": "Merhaba! Kampanyamız başladı.",
"sender": "FirmaAdi",
},
headers={"Authorization": f"Bearer {API_KEY}"}
)
data = response.json()
print(data["message_id"]) # "abc123"
// Java — HttpClient ile SMS gönderimi (Java 11+)"""
import java.net.http.*;
import java.net.URI;

var body = """"""
{"to":"905XXXXXXXXX","message":"Merhaba!","sender":"FirmaAdi"}
""";

var request = HttpRequest.newBuilder()
.uri(URI.create("https://api.vatansms.com/v1/sms"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();

var response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// C# (.NET) — HttpClient ile SMS gönderimi"""
using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add(
"Authorization", $"Bearer {apiKey}""""
);

var payload = new StringContent(
"""{"to":"905XXXXXXXXX","message":"Merhaba!","sender":"FirmaAdi"}""",
Encoding.UTF8, "application/json""""
);

var response = await client.PostAsync(
"https://api.vatansms.com/v1/sms", payload
);
// Node.js — fetch API ile SMS gönderimi"""
const response = await fetch("https://api.vatansms.com/v1/sms", {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "905XXXXXXXXX",
message: "Merhaba! Kampanyamız başladı.",
sender: "FirmaAdi",
}),
});
const data = await response.json();
# cURL — terminal veya shell script"""
curl -X POST https://api.vatansms.com/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"905XXXXXXXXX","message":"Merhaba!","sender":"FirmaAdi"}'
API Referansı

Temel API Endpoint'leri

Base URL: https://api.vatansms.com/v1 — Tüm istekler JSON formatında, Bearer token ile kimlik doğrulaması gerektirir. HTTPS zorunludur; HTTP üzerinden gelen istekler reddedilir.

Method Endpoint Açıklama
POST /sms Tek veya toplu SMS gönderimi
POST /sms/bulk Büyük liste toplu gönderim
GET /sms/{"{"}id{"}"} Gönderim durumu sorgulama
GET /reports Kampanya raporları
GET /balance Kredi bakiyesi sorgulama
POST /webhook Teslim bildirimi webhook kaydı
Kimlik Doğrulama Tüm istekler Authorization: Bearer YOUR_API_KEY header'ı gerektirir. API anahtarı panelden oluşturulur.
Yanıt Formatı Tüm yanıtlar JSON formatındadır. Başarılı yanıtta message_id döner; hata durumunda error_code ve açıklama içerir.

Tam API dokümantasyonu, parametre listesi ve hata kodları için panel hesabınızda Geliştirici bölümünü ziyaret edin.

API Özellikleri

VatanSMS API'sinin Öne Çıkan Özellikleri

Basit bir SMS göndericisinden öte — toplu gönderim, webhook, durum sorgulama ve OTP desteğiyle tam özellikli bir mesajlaşma altyapısı. API anahtarı panelden dakikalar içinde oluşturulur, sandbox ortamında test edilebilir.

REST Mimarisi

HTTP POST/GET istekleri ile her platformdan erişim. JSON istek ve yanıtlar.

Bearer Token Auth

Her istek Authorization header'ı ile güvence altındadır. API anahtarı panelden anında oluşturulur, gerektiğinde yenilenebilir.

Webhook Desteği

Teslim bildirimleri, belirlediğiniz URL'ye otomatik POST ile iletilir. Anlık durum güncellemesi sayesinde manuel sorgulama gerekmez.

Toplu Gönderim

Tek API isteğiyle binlerce numaraya gönderim. /sms/bulk endpoint'i ile büyük listeler desteklenir.

API erişimi ücretsizdir — hesap açın, anahtarınızı oluşturun, hemen entegre etmeye başlayın. Gönderilen SMS'ler için yalnızca standart paket fiyatı uygulanır; ekstra ücret alınmaz.
API Anahtarı Al →
Hazır Entegrasyonlar

Kullandığınız Platforma Anında Bağlanın

Hazır eklentiler sayesinde API bilgisine gerek kalmadan dakikalar içinde entegrasyon tamamlanır. API anahtarınızı girin, kurulum bitti. Listede olmayan bir platform için REST API ile özel entegrasyon yapabilirsiniz.

WooCommerce

Sipariş onayı, kargo bildirimi, OTP ve terk edilmiş sepet SMS'leri. WordPress eklenti dizininden kurulum.

WordPress Eklentisi

WordPress

Kullanıcı kaydı, giriş doğrulama ve içerik bildirimleri için SMS entegrasyonu.

WordPress Eklentisi

OpenCart

Sipariş durumu değişikliği, müşteri bildirimi ve kampanya SMS'leri için OpenCart modülü.

OpenCart Modülü

Joomla

Joomla tabanlı sitelerde üye bildirimleri, etkinlik duyuruları ve OTP SMS entegrasyonu.

Joomla Eklentisi

Zoho CRM

Müşteri süreçlerinde otomatik SMS bildirimler. Lead, fırsat ve görev tetikleyicilerine SMS ekleyin.

Zoho Entegrasyonu

WHMCS

Fatura hatırlatması, domain yenileme bildirimi, destek talebi ve ödeme onayı SMS'leri.

WHMCS Modülü
Kullanım Senaryoları

API ile Neler Yapabilirsiniz?

SMS API, tek seferlik gönderimden tamamen otomatize edilmiş SMS akışlarına kadar geniş bir yelpazeyi destekler. E-ticaret, SaaS, sağlık ve fintech sektörlerindeki en yaygın kullanım senaryolarını aşağıda bulabilirsiniz.

Otomatik Bildirimler
  • Yeni sipariş ve kargo takip bildirimi
  • Ödeme hatırlatması ve fatura bildirimi
  • Randevu hatırlatması ve onay kodu
  • Domain yenileme ve hesap uyarıları
  • Stok geri döndü bildirimi
  • Müşteri yorumu ve geri bildirim talebi
Güvenlik & Doğrulama
  • OTP / iki faktörlü kimlik doğrulama (2FA)
  • Telefon numarası doğrulama
  • Şüpheli giriş uyarısı
  • İşlem onay kodu (ödeme, transfer)
  • Parola sıfırlama kodu
  • Yeni cihaz doğrulama bildirimi
Doğru Aracı Seçin

VatanSMS Paneli mi, SMS API mi?

İkisi birlikte de kullanılabilir — otomatik mesajlar API üzerinden, kampanya ve duyurular panel üzerinden yönetilebilir.

Özellik Web Paneli SMS API
Manuel mesaj gönderme✓ UygunGerekli değil
Otomatik SMS göndermeSınırlı✓ Uygun
İşleme bağlı anlık SMSManuel işlem gerekir✓ Otomatik
OTP doğrulama koduSenaryoya göre✓ Uygun
KişiselleştirmeExcel ile✓ Yazılım verileriyle
Rapor takibi✓ Panelden✓ API + panelden
Teknik ekip ihtiyacı✓ YokBaşlangıçta gerekir
Hangisi size uygun? Ayda birkaç kez kampanya gönderiyorsanız web paneli yeterlidir. Sipariş, randevu, ödeme veya doğrulama işlemlerinde otomatik SMS gerekiyorsa API doğru çözümdür.
Entegrasyon Öncesi

Başlamadan Önce Cevaplamanız Gereken Sorular

Bu soruları önceden yanıtlamak entegrasyon sürecini hızlandırır ve doğru yapıyı kurmanızı sağlar.

?Hangi işlemlerde SMS gönderilecek? (sipariş, randevu, OTP vb.)
?Mesajlar tekil mi yoksa toplu mu gönderilecek?
?Günlük ve aylık tahmini SMS hacmi nedir?
?OTP / doğrulama kodu ihtiyacı var mı?
?Hangi gönderici başlığı kullanılacak?
?Mesaj içerikleri sabit mi, kişiselleştirilmiş mi olacak?
?Teslim raporları yazılım içinde görüntülenecek mi?
?Ticari mesajlarda İYS izin ve ret süreçleri nasıl yönetilecek?
Mesaj Örnekleri

API ile Gönderilen Gerçek Mesaj Senaryoları

Her senaryo için sistem tarafından otomatik oluşturulan örnek SMS metinleri:

Sipariş Onayı
"Sayın müşterimiz, 45821 numaralı siparişiniz alınmıştır. Siparişiniz hazırlandığında tekrar bilgilendirileceksiniz."
Kargo Bildirimi
"45821 numaralı siparişiniz kargoya verilmiştir. Takip numaranız: 123456789."
Randevu Hatırlatma
"15 Temmuz saat 14.30 tarihindeki randevunuzu hatırlatırız. İptal veya değişiklik için bizimle iletişime geçebilirsiniz."
Ödeme Alındı
"1.250 TL tutarındaki ödemeniz alınmıştır. Teşekkür ederiz."
Okul Devamsızlık
"Sayın Velimiz, öğrenciniz bugün okula gelmemiştir. Bilginize sunarız."
Sistem Uyarısı
"Kritik sistem uyarısı: Sunucu bağlantısı kesildi. Lütfen kontrol ediniz."
Desteklenen Yöntemler

Entegrasyon Protokolleri & Diller

REST API'nin yanı sıra XML POST, HTTP GET ve Push raporlama da desteklenmektedir. Mevcut altyapınıza göre en uygun yöntemi seçebilirsiniz.

REST API
XML POST
HTTP GET
Push Raporlama
Web Service
HTTP POST

Dil desteği: PHP · Python · Java · C# · ASP.NET · Go · Delphi · Visual Basic

Gönderim Kuralları

İYS, KVKK ve Mesaj Türü Ayrımı

Ticari Mesajlar

Kampanya, indirim ve tanıtım içerikli SMS'lerde İYS izni zorunludur. Ret listesindeki alıcılara gönderim yapılmamalıdır.

Hizmet Mesajları

Sipariş durumu, ödeme sonucu, randevu ve kullanıcının başlattığı işlem bildirimleri ticari ileti sayılmaz; İYS izni gerektirmez.

OTP Mesajları

Yalnızca doğrulama amaçlı kullanılmalıdır. Aynı OTP mesajıyla ticari ileti izni veya KVKK açık rızası alınmamalıdır.

Sık Sorulan Sorular

SMS API Entegrasyonu Hakkında Sık Sorulan Sorular

VatanSMS API'sine nasıl erişebilirim?

Hesabınızı açtıktan sonra panel üzerinden API anahtarınızı oluşturabilirsiniz. API erişimi tüm SMS paketlerinde ücretsiz olarak sunulmaktadır.

SMS API hangi programlama dillerini destekliyor?

REST mimarisinde çalışır; HTTP isteği yapabilen her dil desteklenir. PHP, Python, Java, .NET, Node.js ve Go için hazır kod örnekleri sunulmaktadır.

WooCommerce SMS entegrasyonu nasıl yapılır?

VatanSMS WooCommerce eklentisini WordPress eklenti dizininden indirin, aktifleştirin ve API anahtarınızı girin. Sipariş onayı, kargo bildirimi ve OTP senaryoları hazır şablonlarla birkaç dakikada kurulur.

API entegrasyonu için teknik bilgi gerekiyor mu?

Hazır eklentiler (WooCommerce, OpenCart vb.) için teknik bilgiye gerek yoktur. Özel entegrasyon için basit HTTP POST istekleri yeterlidir; hazır kod örnekleri kopyala-yapıştır ile çalışır.

API ile OTP SMS gönderebilir miyim?

Evet. API isteğinde type parametresini otp olarak belirterek OTP SMS gönderebilirsiniz. OTP mesajları özel ve öncelikli kanaldan iletilir. OTP SMS detayları →

Gönderim durumunu API üzerinden sorgulayabilir miyim?

Evet. Her gönderim isteğine dönen message_id ile teslim durumunu sorgulayabilirsiniz. Webhook desteği ile teslim bildirimleri otomatik olarak sisteminize gönderilebilir.

API rate limit nedir?

Saniyede gönderebileceğiniz maksimum istek sayısı hesabınızdaki pakete bağlıdır. Yüksek hacimli entegrasyonlar için teknik destek ekibimizle iletişime geçebilirsiniz.

API entegrasyonu ücretsiz mi?

API erişimi tüm SMS paketlerinde ücretsiz olarak sunulmaktadır. Gönderilen SMS'ler için yalnızca standart paket fiyatları uygulanır; ekstra API ücreti alınmaz. Paket fiyatları →

API Anahtarınızı Alın, Entegrasyona Başlayın

Hesap açın, API anahtarınızı oluşturun, kod örneğini kopyalayıp yapıştırın. Aynı gün aktif entegrasyon. Teknik sorunlarda destek ekibimiz her zaman yanınızda.