Versiyon No 3.2.0

GET Format ile SMS Gönderme

---

API kullanarak mesaj göndermenin GET formatını kullanmayı öğrenin. Mesajları GET formatıyla göndermek basit ve anlaşılır bir süreçtir.

Değişkenler ve seçenekler yukarıda belirtilen örneklerde olduğu gibi linkin sonuna eklenir. Bağlantı yapısı aşağıdaki gibidir:

								
				api/v3/get/get.php?api_key=API_KEY_HERE&mobile=MOBILE_HERE&title=TITLE_HERE&text=SMS_TEXT_HERE&report=1&lang=2&response_type=json&content_type=0
								
							

GET isteğinde veriler URL içinde gönderilir, bu da onları görünür ve anlaması kolay hale getirir. Parametreler, bir soru işaretinden (`?`) sonra URL'ye eklenir ve her parametre-değer çifti bir ampersand (`&`) ile ayrılır. Bu basitlik, test etmek ve hızlı entegrasyon için uygun kılar.

Önemli bir not olarak, URL içinde verilerin görünür olması nedeniyle güvenlik nedenleriyle hassas bilgiler GET istekleri aracılığıyla iletilmemelidir. Hassas veriler için POST yönteminin kullanılması önerilir.

OTP SMS Gönderme

---

OTP servisi, "Bir Kullanımlık Şifre" anlamına gelen kısaltmasıyla, bir defaya mahsus kullanılmak üzere rastgele oluşturulan bir kod üretir. Bu kod, SMS aracılığıyla gönderilir ve doğrulama işlemlerinde, giriş prosedürlerinde ve hesap onaylarında kullanılır. OTP, genellikle giriş süreçleriniz için güvenliği artırmak amacıyla iki faktörlü kimlik doğrulamada kullanılır. OTP'nin önemli bir özelliği, şifrenin yalnızca bir defa kullanılabilir olmasıdır, bu da siber saldırılara ve şifre tahmin girişimlerine karşı ek güvenlik sağlar.

SMS OTP gönderme için doğrudan API bağlantısı [GET] şu şekildedir:

Bağlantı üzerinden gönderilen değişkenler şunlardır:

                
$api_key  = '';
$mobile   = '';
$digits   = '';
$report   = '';
$lang     = '';
$response_type = '';
                
            

Bağlantı üzerinden gönderilen değişkenlerin açıklamaları:

api_key$	varchar	API anahtarınız buraya yerleştirilir.
mobile$	int	Alıcı numarası. Harf veya semboller içermemelidir.
digits$	int	Doğrulama kodundaki rakam sayısı.
report$	int	Teslimat raporunu gösterme seçeneği. 1 göstermek için, 0 iptal etmek için.
lang$	int	Gönderilen mesajın dil seçeneği. 2 Arapça, 0 İngilizce.
response_type$	int	Sunucu yanıtını belirli bir programlama dilinde gösterme seçeneği.

Gönderme işleminden sonra, sunucu aşağıdakilerle yanıt verecektir:

Gönderme işleminden sonra sunucunun örnek yanıtı:

                
Array
(
	[result] => true
	[otp_code] => 123456
	[sms_id] => 1000007721
	[number_of_sms] => 1
	[result_code] => TS-1024
	[result_message] => The message was sent successfully
	[sms_lang] => English
	[country] => Turkey-TR
)
                
            

Sunucudan gelen değişkenlerin açıklamaları:

result	İşlemin sonucu. "true" başarıyı, "false" başarısızlığı gösterir.
otp_code	Alıcıya gönderilen doğrulama kodu.
sms_id	İşlemin kaydedilen ID'si, mesajın durumunu takip etmeye olanak tanır.
number_of_sms	Mesajı gönderdikten sonra hesabınızdan düşülen mesaj sayısı veya kredi sayısı.
result_code	İşlem kodu. Tam ayrıntılar için gönderme kodları bölümüne başvurun.
result_message	Gönderilen işlemin mesajı. İşlemin başarısı veya başarısızlığı hakkında bir mesaj görüntüler.
sms_lang	Gönderilen mesajın dili.
country	Mesajın gönderildiği ülkenin adı.

Gönderme Seçenekleri

---

Gönderme seçenekleri, bir API aracılığıyla gönderilen bir mesajın özelliklerini temsil eder, örneğin, mesaj içeriğinin dili veya bir raporun görünümü gibi.

Yanıt Kodları (Response Codes)

---

Doğrudan API bağlantısı üzerinden bir mesaj gönderildiğinde, sunucu işlemin sonucunu belirtmek için bir kodla yanıt verecektir. Bu kodlar, gerçekleştirdiğiniz işlemin sonucu hakkında bilgi sağlar.

SMS Durumunu Kontrol Etme

---

Yetkilendirme kodu doğrulama, API'ye iki parametre ile POST isteği yaparak yapılabilir: alıcı cep telefonu numarası

								
turkeysms.com.tr/api/v3/sms-durumu/sms_durumu.php?api_key=API_KEY_HERE&sms_id=SMS_ID_HERE&response_type=php
								
							

Link üzerinden gönderilen değişkenler

								
$api_key  = '';
$sms_id	  = '';
$response_type = '';
								
							

Parametre Açıklaması

api_key$	varchar	Hesabınızdaki API anahtarınız buraya yerleştirilecektir
sms_id$	int	Mesaj Kimliği
response_type$	int	Yanıt JSON veya PHP olarak gönderiliyor

Çağrı Geri Raporları

Örnek Yanıt

								
Array
(
	[result] => true
	[sender_id] => SenderID
	[date_of_sending] => 2021-01-01
	[time_of_sending] => 13:10:00
	[sms_status] => Number received the message
	[sms_status_code] => TS-1024
	[sms_balance] => 1 SMS
	[operator] => Turkcell
)
								
							

Parametre Açıklaması

result	İşlemin sonucu, başarılı ise true görünür ve iletim başarısız olursa false görünür
sender_id	Mesaj Kimliği. Bu parametrenin uzunluğu her istekte değişebilir
date_of_sending	Mesajın gönderildiği tarih
time_of_sending	Mesajın gönderildiği saat
sms_status	Mesaj Durumu - Teslim Edildi - Teslim Edilmedi - Numara kapsama dışında
sms_status_code	Durum Kodu
sms_balance	Kullanılan kredi sayısı
operator	Numaranın hangi şirkete ait olduğu

Bakiye Sorgulama [POST]

---

Hesabınızdaki mevcut bakiyeyi sorgulayabilirsiniz, hem yerel hem de uluslararası.

				
turkeysms.com.tr/api/v3/bakiye_sorgulama/add-content
				
							

Gönderilen sorgu için değişkenler:

				
$api_key  = '';
$response_type = '';
				
							

Bağlantı üzerinden gönderilen değişkenlerin açıklaması:

api_key$	varchar	Buraya API anahtarınızı yerleştirin.
response_type$	int	Sunucu yanıtını belirli bir programlama dilinde görüntüleme seçeneği.

Sorgulama işleminden sonra sunucu şu şekilde yanıt verecektir:

Sunucudan gelen örnek yanıt:

Array
(
	[result] => true
	[result_code] => TS-1040
	[result_message] => operation_success
	[api_key] => api_key
	[local_balance_sms] => 1
	[international_balance_tl] => 1
)
				

Sunucudan gelen değişkenlerin açıklaması:

result	İşlemin sonucu. "true" başarıyı, "false" başarısızlığı gösterir.
result_code	İşlem kodu.
result_message	İşlem mesajının içeriği.
api_key	Burada hesabın bağlantı anahtarı görünür.
local_balance_sms	Yerel bakiye - Türkiye içinde, mesaj sayısı olarak görüntülenir.
international_balance_tl	Uluslararası bakiye - Türk Lirası cinsinden finansal bir değer olarak görüntülenir.

Uluslararası SMS

---

"Uluslararası mesajlar" terimi, Türkiye Cumhuriyeti sınırları dışına gönderilen mesajları ifade eder.
Bu mesajlar, uluslararası kod ile başlamayan (+90-0090) tüm numaraları içerir.
Türkiye SMS servisi, hesabınız aracılığıyla dünya genelinde herhangi bir ülkeye SMS göndermenize olanak tanır. Ancak, herhangi bir ülkeye mesaj göndermek için hesabınıza uluslararası bakiye yüklemeniz gerekmektedir.
Mesajın fiyatı ülkeden ülkeye değişir ve uluslararası mesajın teslim süresi de değişiklik gösterir. Uluslararası gönderim yapabilmek için hesabınızı etkinleştirmek için Türkiye SMS servisinin Teknik Destek Merkezi ile iletişime geçmelisiniz.

Nasıl API aracılığıyla uluslararası bir mesaj gönderirim?

Örnek

---

Metin mesajlaşma sistemi, sorunsuz entegrasyon için çeşitli programlama dillerini destekler. Aşağıda farklı programlama dilleri için örnekler bulunmaktadır:

PHP Java JavaScript NodeJS Python CSharp C(LibCURL) Go ObjectiveC Ruby Swift

PHP

function sendRequest($site, $data)
{
    $json = json_encode($data);
    $ch = curl_init($site);
    $header = array('Content-Type: application/json');
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
    $result = curl_exec($ch);
    curl_close($ch);
    return $result;
}
$api_key  = '';
$title    = '';
$text	  = '';
$sentto	  = '';

$body = array("api_key" => $api_key, "title"=>$title, "text"=>$text,"sentto"=>$sentto);
$result = sendRequest('/api/v3/gonder/add-content', $body);
//http://www.lalit.org/lab/convert-xml-to-array-in-php-xml2array/

JAVA

Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("/api/v3/gonder/add-content")
.header("Content-Type", "application/json")
.body("{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}")
.asString();

JavaScript

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({"api_key":"API_KEY_HERE","title":"SMS_TITLE_HERE","text":"TEXT_SMS","sentto":"90500000000"});

var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};

fetch("/api/v3/gonder/add-content", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));

Python

import requests

url = "/api/v3/gonder/add-content"

payload = "{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}"
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

Ruby

require "uri"
require "net/http"

url = URI("/api/v3/gonder/add-content")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = "{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}"

response = https.request(request)
puts response.read_body

CSharp

var client = new RestClient("/api/v3/gonder/add-content");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

C(LibCURL)

CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
  curl_easy_setopt(curl, CURLOPT_URL, "/api/v3/gonder/add-content");
  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
  struct curl_slist *headers = NULL;
  headers = curl_slist_append(headers, "Content-Type: application/json");
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  const char *data = "{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}";
  curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
  res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);

NodeJS

var unirest = require('unirest');
var req = unirest('POST', '/api/v3/gonder/add-content')
  .headers({
    'Content-Type': 'application/json'
  })
  .send(JSON.stringify({"api_key":"API_KEY_HERE","title":"SMS_TITLE_HERE","text":"TEXT_SMS","sentto":"90500000000"}))
  .end(function (res) { 
    if (res.error) throw new Error(res.error); 
    console.log(res.raw_body);
  });

ObjectiveC

#import  Foundation/Foundation.h>

dispatch_semaphore_t sema = dispatch_semaphore_create(0);

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"/api/v3/gonder/add-content"]
  cachePolicy:NSURLRequestUseProtocolCachePolicy
  timeoutInterval:10.0];
NSDictionary *headers = @{
  @"Content-Type": @"application/json"
};

[request setAllHTTPHeaderFields:headers];
NSData *postData = [[NSData alloc] initWithData:[@"{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}" dataUsingEncoding:NSUTF8StringEncoding]];
[request setHTTPBody:postData];

[request setHTTPMethod:@"POST"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
  } else {
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
    NSError *parseError = nil;
    NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
    NSLog(@"%@",responseDictionary);
    dispatch_semaphore_signal(sema);
  }
}];
[dataTask resume];
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);

Go

package main
import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)
func main() {
  url := ""/api/v3/gonder/add-content"
  method := "POST"
  payload := strings.NewReader("{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}")
  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}

Swift

import Foundation

var semaphore = DispatchSemaphore (value: 0)

let parameters = "{\"api_key\":\"API_KEY_HERE\",\"title\":\"SMS_TITLE_HERE\",\"text\":\"TEXT_SMS\",\"sentto\":\"90500000000\"}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "/api/v3/gonder/add-content")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}

task.resume()
semaphore.wait()

SMS Kütüphaneleri

---

Kullanmak istediğiniz programlama dilinde hazır dosyaları indirebilirsiniz.