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.
Hesabım - API Bilgilerimi Görüntüle kısmından api_id ve api_key bilgilerinize ulaşabilirsiniz.
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}");
}
}
}
}
}