Geliştirici merkezine hoş geldiniz. TurkeySMS API, SMS yeteneklerini doğrudan dijital ekosisteminize — web platformları, mobil uygulamalar veya kurumsal ERP sistemleri — entegre etmek için güçlü, güvenli ve ölçeklenebilir programatik çözümler sunar.

API'miz Node.js, Python ve C# dahil olmak üzere tüm modern ortamlarda sorunsuz çalışacak şekilde tasarlanmıştır. Entegrasyon süresini en aza indirirken mesaj iletim performansını maksimize etmek için kapsamlı SDK'lar ve özel araçlar sunuyoruz.

TurkeySMS ile entegrasyon, akıllı ve gerçek zamanlı iletişim kanalları oluşturmanıza olanak tanır. Otomatik sistem bildirimlerinden çok faktörlü doğrulamaya (OTP) kadar, en yüksek uluslararası güvenlik standartlarını karşılayan güvenilir bir iletişim omurgası sunuyoruz.

Başarılı bir entegrasyon sağlamak ve yasal düzenlemelere uyum sağlamak için lütfen aşağıdaki gereksinimleri doğrulayın:

Sadece 3 adımda ilk SMS'inizi göndermeye başlayın:

require_once 'TurkeySmsClient_TR.php';

$client = new TurkeySmsClient('YOUR_API_KEY');
$result = $client->sendSms('SenderID', '905xxxxxxxxx', 'Merhaba!');

if ($client->isLastSuccess()) {
    echo "✅ Gönderildi! ID: " . $result['sms_id'];
}

Kimlik doğrulama, JSON istek gövdesi (body) içinde gönderilen size özel API anahtarınız kullanılarak gerçekleştirilir.

API anahtarınıza kontrol panelinizde Hesabım → API Ayarları bölümünden ulaşabilirsiniz.

API anahtarınızın geçerliliğini kontrol etmenizi ve atanan tüm yetkileri (Gönderim, OTP, Bakiye) ve mevcut hesap durumunu görmenizi sağlayan profesyonel bir uç nokta.

İstek Örneği (CURL)

curl -X POST https://api.turkeysms.com.tr/auth/check \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY"
}'

Yanıt Örneği (JSON)

{
    "result": true,
    "result_code": "TS-1000",
    "key_details": {
        "status": "Active",
        "permissions": {
            "post_request": true,
            "send_single_sms": true,
            "send_otp": true,
            "check_balance": true,
            "check_senderid": true,
            "manage_groups": true
        }
    },
    "account_summary": {
        "account_status": "Active",
        "balance": {
            "main": 1500,
            "international": 250
        }
    }
}

Belirli bir telefon numarasına POST isteği ile tek bir SMS gönderin:

Parametreler

İstek Örneği

$data = [
    "api_key"       => "YOUR_API_KEY",
    "title"         => "SirketIsmi",
    "text"          => "Merhaba! Bu bir test mesajıdır.",
    "sentto"        => "905xxxxxxxxx",
    "report"        => 1,
    "sms_lang"      => 1,
    "content_type"  => 0,
    "response_type" => "json"
];

$ch = curl_init("https://api.turkeysms.com.tr/sms/send");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Başarılı Yanıt Örneği

{
    "result":         true,
    "result_code":    "TS-1024",
    "result_message": "SMS dispatched successfully.",
    "sms_id":         1000007721,
    "number_of_sms":  1,
    "sms_lang":       "Turkish",
    "content_type":   "Transactional",
    "country":        "Turkey-TR"
}

Yanıt Alanları

Tek Kullanımlık Şifre (OTP) göndermek için özel uç nokta. Bu API, mesaj kuyruğunda en yüksek önceliğe sahip olarak ultra hızlı teslimat sağlar.

Parametreler

İstek Örneği

$data = [
    "api_key"       => "YOUR_API_KEY",
    "mobile"        => "905xxxxxxxxx",
    "lang"          => 1,
    "digits"        => 4,
    "report"        => 1,
    "response_type" => "json"
];

$ch = curl_init("https://api.turkeysms.com.tr/otp/send");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Başarılı Yanıt Örneği

{
    "result":         true,
    "sms_id":         654321,
    "otp_code":       1458,
    "number_of_sms":  1,
    "result_code":    "TS-1024",
    "result_message": "The message was sent successfully",
    "sms_lang":       "Turkish",
    "content_type":   "High_quality",
    "country":        "Turkey-TR"
}

Metin formatını kontrol ettiğiniz özel OTP (Tek Kullanımlık Şifre) mesajları göndermek için özel uç nokta.
ÖNEMLİ: Bu özelliği kullanabilmek için hesabınızda aktif bir Gönderici Kimliğine (Sender ID) sahip olmanız ZORUNLUDUR. Ayrıca metnine TS-CODE anahtar kelimesini EKLEMENİZ GEREKİR, bu kelime otomatik olarak üretilen OTP kodu ile değiştirilecektir.

Parametreler

İstek Örneği

$data = [
    "api_key"       => "YOUR_API_KEY",
    "mobile"        => "905xxxxxxxxx",
    "title"         => "YOUR_TITLE",
    "text"          => "Servisimize Hoşgeldiniz! TS-L Doğrulama kodunuz: TS-CODE",
    "lang"          => 1,
    "digits"        => 4,
    "report"        => 1,
    "response_type" => "json"
];

$ch = curl_init("https://api.turkeysms.com.tr/otp/detailed");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);
curl_close($ch);

Başarılı Yanıt Örneği

{
    "result":         true,
    "sms_id":         654322,
    "otp_code":       8591,
    "number_of_sms":  1,
    "result_code":    "TS-1024",
    "result_message": "The message was sent successfully",
    "sms_lang":       "Turkish",
    "content_type":   "High_quality",
    "country":        "Turkey-TR"
}

Bu arayüz, kişi gruplarınızı programlı olarak yönetmenize olanak tanır. Yeni gruplar oluşturabilir, adlarını düzenleyebilir, silebilir veya mevcut tüm grupları listeleyebilirsiniz.

1. Yeni Grup Oluştur

Parametreler: api_key, group_name.

curl -X POST https://api.turkeysms.com.tr/groups/create \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY",
    "group_name": "My New Group"
}'

2. Grup Adını Düzenle

Parametreler: api_key, group_id, new_name.

curl -X POST https://api.turkeysms.com.tr/groups/edit \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY",
    "group_id": 1234,
    "new_name": "Updated Name"
}'

Yanıt Örneği (Düzenle)

{
    "result": true,
    "result_code": "TS-1081",
    "result_message": "Group updated successfully",
    "new_name": "Updated Name"
}

3. Grubu Sil (Delete - Soft)

Parametreler: api_key, group_id.

curl -X POST https://api.turkeysms.com.tr/groups/delete \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY",
    "group_id": 1234
}'

Yanıt Örneği (Sil)

{
    "result": true,
    "result_code": "TS-1082",
    "result_message": "Group deleted successfully"
}

4. Grupları Listele (List)

Parametreler: api_key, search (isteğe bağlı).

curl -X POST https://api.turkeysms.com.tr/groups/list \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY",
    "search": "Team"
}'

Yanıt Örneği (Grupları Listele)

{
    "result": true,
    "result_code": "TS-1083",
    "groups_count": 2,
    "groups": [
        { "id": 123, "name": "Team A", "date": "2026-04-01" },
        { "id": 456, "name": "Clients", "date": "2026-04-02" }
    ]
}

Yanıt Örneği (Grup Oluşturma)

{
    "result": true,
    "result_code": "TS-1080",
    "result_message": "Group created successfully",
    "group": {
        "id": 5412,
        "name": "Ekibim",
        "created_at": "2026-04-03"
    }
}

Bu arayüz, kişi numaralarını programlı olarak mevcut gruplarınıza eklemenize olanak tanır ve özel alan desteği sunar.

1. Gruba Numara Ekle (Add)

Parametreler: api_key (zorunlu), group_id (zorunlu), gsm_number (zorunlu), name (isteğe bağlı), f_01, f_02, f_03 (özel alanlar).

curl -X POST https://api.turkeysms.com.tr/contacts/add \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY",
    "group_id": 1234,
    "gsm_number": "905051234567",
    "name": "Ahmet Yılmaz",
    "f_01": "Ekstra Bilgi"
}'

Yanıt Örneği (Numara Ekleme)

{
    "result": true,
    "result_code": "TS-1100",
    "result_message": "Contact added successfully",
    "total_added": 1,
    "total_failed": 0,
    "mobile": "905050300074"
}

Pazarlama kampanyalarınıza ve hedef kitle iletişimine uygun olarak iki farklı yolla toplu mesaj gönderebilirsiniz.

1. Birden Çok Numaraya Tek Metin Gönderin

Belirli bir numara listesine sabit tek bir mesaj gönderin.

2. Birden Çok Numaraya Birden Çok Metin Gönderin

Her bir numaraya karşılık gelen özel mesajlar gönderin (Dizi indeksleri birbirleriyle eşleşmelidir).

Toplu Gönderim Parametreleri

İstek Örneği

$client = new TurkeySmsGroupClient_TR('YOUR_API_KEY');

// Birden Çok Numaraya Tek Metin Gönder
$result = $client->sendSingleTextToMultipleNumbers(
    'GondericiID',                  // Gönderici ID
    'Herkese uygulanan metin',      // SMS Metni
    ['905000000001', '905000000002']  // Numara dizisi
);

// Birden Çok Numaraya Çoklu Metin Gönder
$multiResult = $client->sendMultipleTextsToMultipleNumbers(
    'GondericiID',
    ['Merhaba Ali', 'Merhaba Ayşe'],
    ['905000000001', '905000000002']
);

Başarılı Yanıt Örneği

{
    "result":             true,
    "rapor_id":           123456,
    "total_mobile_num":   2,
    "number_of_sms":      2,
    "result_code":        "TS-1024",
    "result_message":     "The message was sent successfully",
    "sms_lang":           "Turkish",
    "country":            "Turkey-TR"
}

Bu uç nokta (endpoint), hesabınızdaki mevcut bakiyeyi doğrudan sorgulamanıza olanak tanır. Kontrol panelinizdeki API anahtarı ayarlarından Bakiye Sorgulama seçeneğini etkinleştirmeniz gerekir.

İstek Örneği (CURL)

curl -X POST https://api.turkeysms.com.tr/balance/ \
-H "Content-Type: application/json" \
-d '{ "api_key": "YOUR_API_KEY" }'

Bakiye Yanıt Örneği

{
    "result":                       true,
    "result_code":                  "TS-1040",
    "result_message":               "operation_success",
    "local_balance_sms":            5400,
    "international_balance_tl":     30.50
}

PHP SDK Kullanımı

$client = new TurkeySmsBalanceClient_TR('API_ANAHTARINIZ');
$result = $client->checkBalance();

if (!empty($result['result'])) {
    echo "Yerel SMS Bakiyesi: " . $result['local_balance_sms'];
}

Bu arayüz, müşterilerin belirli telefon numaralarını engellemesine ve programlı olarak onlara herhangi bir mesaj gönderilmesini önlemesine olanak tanır. Kara liste her kullanıcı için bağımsız olarak yönetilir.

1. Kara Listeye Numara Ekle (Add to Blacklist)

Gerekli Parametreler: api_key, number.

curl -X POST https://api.turkeysms.com.tr/blacklist/add \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY",
    "number": "905xxxxxxxx"
}'

2. Kara Liste Durum Sorgulama (Check Status)

Parametreler: api_key, number.

{
    "status": "success",
    "result_code": "TS-1143",
    "is_blocked": true,
    "block_date": "2026-04-03",
    "block_time": "17:50"
}

Bu arayüz, gönderim sırasında aldığınız benzersiz kimliği (SMS ID) kullanarak belirli bir mesajın teslimat durumunu sorgulamanıza olanak tanır.

İstek Örneği (CURL)

curl -X POST https://api.turkeysms.com.tr/sms/status \
-H "Content-Type: application/json" \
-d '{
    "api_key": "YOUR_API_KEY",
    "sms_id": 12345678
}'

Gerekli Parametreler

Başarılı Yanıt Örneği (Teslim Edildi)

{
    "status": "success",
    "result_code": "TS-1064",
    "result_message": "Number received the message.",
    "result": true,
    "sender_id": "SENDER",
    "sms_status": "Number received the message",
    "sms_balance": "1 SMS"
}

Mesaj Dili — sms_lang

İçerik Türü — content_type

Yanıt Formatı — response_type

Her işlem sonucunu belirten bir durum kodu döndürür. Sorunları teşhis etmek için bu tabloyu kullanın.

Mesaj durumunu sorgulamak için API'yi sürekli kontrol etmek yerine, TurkeySMS Webhooks özelliğini kullanarak iletim raporlarını doğrudan sunucunuza "Push" eder. Bu, sunucu yükünü azaltır ve verilerin anlık olarak senkronize edilmesini sağlar.

İmza Doğrulama (Güvenlik)

İsteklerin gerçekten sunucularımızdan geldiğinden emin olmak için X-TurkeySms-Signature başlığını gönderiyoruz. Bu, size özel Webhook Gizli Anahtarınız (Secret Key) kullanılarak oluşturulan bir HMAC-SHA256 özetidir.

Örnek Alıcı Kodu (PHP)

<?php
$secret = "YOUR_WEBHOOK_SECRET";
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_TURKEYSMS_SIGNATURE'] ?? '';

// Güvenlik için imzayı doğrula
$expectedSignature = hash_hmac('sha256', $payload, $secret);

if (hash_equals($expectedSignature, $signature)) {
    $data = json_decode($payload, true);
    // İletim raporunu burada işleyin
    file_put_contents('webhook_log.txt', $data['data']['sms_id'] . ": " . $data['data']['status']);
    http_response_code(200);
} else {
    http_response_code(403); // Yetkisiz istekleri reddet
}
?>

Karmaşık kodlama gerektirmeden entegrasyon sürecinizi basitleştirmek için dünyanın en popüler platformları için kullanıma hazır çözümler sunuyoruz.

TurkeySMS'i Make.com (eski adıyla Integromat) senaryolarınıza yerel olarak entegre edin. Resmi uygulamamızla, tek bir satır kod yazmadan iletişim iş akışlarınızı otomatikleştirebilirsiniz.

Mevcut Modüller

• Tekli SMS Gönder: Bildirimleri, uyarıları ve pazarlamayı otomatikleştirin.
• OTP Gönder: Doğrulama kodları için hızlı teslimat.
• Bakiye Sorgula: Kredilerinizi gerçek zamanlı olarak izleyin.
• Kimlik Doğrulama Bağlantısı: API anahtarınızı bir kez güvenli bir şekilde girin ve senaryolar arasında kullanın.

Nasıl Kurulur?

1. Make.com senaryonuzda TurkeySMS modülünü ekleyin.
2. Add Connection seçeneğine tıklayın ve bağlantıya bir isim verin (örn. "Hesabım").
3. TurkeySMS Panelinizden kopyaladığınız API Anahtarını yapıştırın.
4. Modül parametrelerinizi yapılandırın ve otomatikleştirmeye başlayın!

Entegrasyonunuzu hızlandırmak için en popüler programlama dilleri için tam belgeli SDK'lar sunuyoruz. Tüm kütüphanelerimiz Anında SMS, OTP, Zamanlanmış Mesajlaşma ve Toplu SMS özelliklerini destekler.