Güvenlik, bilgilendirme ve tanıtım mesajlarınızı otomatikleştirin. Müşterilerinizi her durumda otomatik olarak gidecek mesajlarla anında haberdar edin, iletişiminiz ve marka değeriniz yükselsin. En çok kullanılan yazılım dillerine göre hazırladığımız örnek kodlarımızı inceleyin.

dilinde oluşturduğumuz SMS API servisimizi VatanSMS kullanıcı adı ve şifre bilgilerinizi girerek kolayca sisteminize entegre edebilir ve mesaj gönderimini otomatik hale getirebilirsiniz.


PHP SMS API SDK (Github):

ASP.NET SMS API SDK (Github):

Delphi SMS API SDK (Github):

VB.NET SMS API SDK (Github):

Kod Örnekleri

Sisteminize kolayca entegre edebileceğiniz SMS API servisimiz ile müşterilerinize şifre doğrulama, otomatik onay veya bilgi mesajları gönderin. Toplu SMS gönderimi gibi birçok avantaj elde edeceğiniz SMS API scripti örnek ve dokümanlarımızı inceleyin.

1 - N

sender olarak hesabınıza tanımlanmış olan gönderici adını göndermelisiniz. Türkçe SMS gönderimi için 'message_type': turkce olarak gönderilmelidir.

İleri tarihli SMS göndermek için datanın içerisine 'send_time' : '2021-05-25 12:00:00' (Y-m-d H:i:s) şeklinde gönderilmelidir. Hemen gönderim yapmak için send_time'ı göndermemelisiniz.

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/1toN";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\",
                    \"sender\": \"SMSBASLIGINIZ\",
                    \"message_type\": \"normal\",
                    \"message\": \"Bu bir test mesajıdır.\",
                    \"message_content_type\": \"bilgi\",
                    \"phones\": [\"555555555\"]
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }                                                                                    
                                                                                    

N - N

sender olarak hesabınıza tanımlanmış olan gönderici adını göndermelisiniz. Türkçe SMS gönderimi için 'message_type': turkce olarak gönderilmelidir.

İleri tarihli SMS göndermek için datanın içerisine 'send_time' : '2021-05-25 12:00:00' (Y-m-d H:i:s) şeklinde gönderilmelidir. Hemen gönderim yapmak için send_time'ı göndermemelisiniz.

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/NtoN";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\",
                    \"sender\": \"SMSBASLIGINIZ\",
                    \"message_type\": \"normal\",
                    \"send_time\": \"2021-05-19 15:33:00\",
                    \"message_content_type\": \"bilgi\",
                    \"phones\": [
                        { \"phone\": \"5xxxxxxxxx\", \"message\": \"Bu bir test mesajıdır.\" },
                        { \"phone\": \"5xxxxxxxxx\", \"message\": \"Bu bir test mesajıdır.\" }
                    ]
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }                                                                                    
                                                                                    

Gönderici Adı Sorgulama

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/senders";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\"
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }                                                                                    
                                                                                    

Kullanıcı Bilgilerini Alma

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/user/information";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\"
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }                                                                                    
                                                                                    

Rapor Sorgulama - Rapor Detayı

report_id her SMS gönderimi sonrasında dönen id değeridir.

Eğer datanın sayfalamalı dönmesini istiyorsana page'i göndermeniz gerekmektedir. Sayfalar default olarak 20 şerli dönmektedir. Eğer isterseniz 1-100 arasında bir değeri pageSize'da göndererek değiştirebilirsiniz.

Eğer direkt sayfalamasız olarak bütün datayı almak istemiyorsanız page ve pageSize göndermemelisiniz.

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/report/detail?page=1&pageSize=20";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\",
                    \"report_id\": 926410
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }                                                                                    
                                                                                    

Rapor Sorgulama - Tarih Bazlı

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/report/between";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\",
                    \"start_date\": \"2021-05-17 11:22:00\",
                    \"end_date\": \"2021-05-18 11:31:00\"
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }                                                                                    
                                                                                    

Rapor Sorgulama - Sonuç Sorgusu

report_id her SMS gönderimi sonrasında dönen id değeridir.

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/report/single";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\",
                    \"report_id\": 926382
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }                                                                                    
                                                                                    

İleri Tarihli SMS İptal

İleri tarihli SMS iptal etmek için datanın içerisine 'id (Rapor ID)' : 'xxx' şeklinde gönderilmelidir.

                                                                                    
                                                                                    
    using System;
    using System.IO;
    using System.Net;
    using System.Text;

    namespace SmsApiExample
    {
        class Program
        {
            static void Main(string[] args)
            {
                var apiUrl = "https://api.vatansms.net/api/v1/cancel/future-sms";
                var jsonData = @"
                {
                    \"api_id\": \"API_ID\",
                    \"api_key\": \"API_KEY\",
                    \"id\": xxx
                }";

                var request = (HttpWebRequest)WebRequest.Create(apiUrl);
                request.ContentType = "application/json; charset=utf-8";
                request.Method = "POST";

                using (var streamWriter = new StreamWriter(request.GetRequestStream()))
                {
                    streamWriter.Write(jsonData);
                    streamWriter.Flush();
                    streamWriter.Close();
                }

                try
                {
                    var response = (HttpWebResponse)request.GetResponse();
                    using (var streamReader = new StreamReader(response.GetResponseStream()))
                    {
                        var result = streamReader.ReadToEnd();
                        Console.WriteLine(result);
                    }
                }
                catch (WebException ex)
                {
                    using (var streamReader = new StreamReader(ex.Response.GetResponseStream()))
                    {
                        var error = streamReader.ReadToEnd();
                        Console.WriteLine($"Error: {error}");
                    }
                }
            }
        }
    }