HTTP GET Yöntemi ile Toplu SMS Gönderimi

HTTP GET Yöntemi ile SMS Gönderimi

HTTP GET yöntemi, URL parametreleri aracılığıyla SMS gönderme isteklerini iletiMerkezi altyapısına iletmektedir. Aşağıdaki gibi bir link oluşturup bu adrese HTTP isteği yapmanız, SMS'lerinizin iletilmesi için yeterlidir.

Bu yöntem, basit ve hızlı gönderimler için ideal olup, doğrudan tarayıcıda test etme imkanı sağlar.

http://api.iletimerkezi.com/v1/send-sms/get/?username=KULLANICI_ADI&password=KULLANICI_SIFRESI&text=Lorem%20ipsum%20dolor%20sit%20amet&receipents=5301234569, 5301234570&sender=ILETI%20MRKZI

HTTP GET API URL Yapısı ve Parametreleri

Yukarıdaki link farklı parametrelerden oluşmaktadır. Her bir parametre aşağıdaki gibi açıklanmaktadır:

Kimlik Doğrulama Parametreleri

username: iletiMerkezi paneline giriş yaparken kullandığınız kullanıcı adıdır. Genellikle kayıt aşamasında verilen cep telefonu numarasıdır.

password: iletiMerkezi paneline giriş yaparken kullandığınız şifredir. API çağrılarında güvenli bir şekilde iletilmelidir.

Mesaj İçeriği Parametreleri

text: Gönderilecek olan SMS metnini içerir. URL kodlanmış format kullanılmalıdır.

receipents: Alıcının cep telefonu numarasını içerir. Birden fazla alıcı tanımlanacaksa numaralar virgül ile ayrılmalıdır. Örnek format: (905301234567,905309876543)

Gönderen Kimliği

sender: SMS’in alıcının telefonunda hangi isimle görünmesini istiyorsanız, önceden onaylı başlık adınızı yazmalısınız.

Önemli Dikkat Edilecek Noktalar

HTTP GET yöntemi kullanırken aşağıdaki hususlara dikkat edilmelidir:

Başlık Tanımı

Kullandığınız başlığın hesabınızda önceden tanımlı ve onaylı olması gerektiğidir. Onay almamış bir başlık kullanırsanız gönderim başarısız olacaktır.

URL Kodlama

URL'nin yapısını bozacak özel karakterler (Türkçe karakterler, boşluk vb.) mutlaka kodlanmalıdır. Her yazılım dilinde tanımlı fonksiyonları bu amaçla kullanabilirsiniz.

Örnek olarak:

• PHP dilinde: urlencode fonksiyonunu kullanmalısınız
• JavaScript'te: encodeURIComponent() fonksiyonunu kullanmalısınız
• Python'da: urllib.parse.quote() kullanılmalıdır

PHP ile gönderim örneği

$username = urlencode('KULLANICI_ADI');
$password = urlencode('KULLANICI_SIFRESI');
$text = urlencode('Doğrulama kodunuz: 4556');
$receipents = urlencode('5301234569,5301234570');
$sender = urlencode(ILETI MRKZI);
 
$url = "http://api.iletimerkezi.com/v1/send-sms/get/?username=".$username.
  "&password=".$password.
  "&text=".$text.
  "&receipents=".$receipents.
  "&sender=".$sender;
 
file_get_contents($url);

11 Temmuz 2015