Ana içeriğe geç

Get API

SMS Gönderme işlemini, HTTP protokolünün GET metodu ile yapmak isterseniz aşağıdaki yönergeleri takip edebilirsiniz. Genelde hazır yazılımların veya firewall gibi donanımların/cihazların SMS entegrasyon panellerindeki ayarları buradaki dökümantasyon yardımıyla İleti Merkezi'ne entegre edebilirsiniz.

İstek yapılacak adres

GEThttps://api.iletimerkezi.com/v1/send-sms/get/

İstek Parametreleri

https://api.iletimerkezi.com/v1/send-sms/get/?key=API_KEY&hash=API_HASH&text=Lorem%20ipsum%20dolor%20sit%20amet&receipents=5301234569,5301234570&sender=APITEST&iys=1&iysList=BIREYSEL
İpucu

İstek parametrelerine kendi değerlerinizi yazdıktan sonra, oluşan url adresini tarayıcınızın adres alanına yazarak entegrasyonu deneyebilirsiniz, eğer bir hata alıyorsanız durum ve hata kodları kısmından hatanın nasıl çözülebileceğine bakabilirsiniz.

Tanımlar

İstekte gönderilen parametrelerin açıklamaları aşağıdaki gibidir:

  • key: iletimerkezi.com panelinize giriş yaptıktan sonra ayarlar bölümünden oluşturabileceğiniz API Anahtar bu alana yazılmalıdır. İstek yapılırken gönderilmesi zorunludur.

  • hash: iletimerkezi.com panelinize giriş yaptıktan sonra ayarlar bölümünden oluşturabileceğiniz API Anahtar ve Gizli Anahtar kullanılarak oluşturulmuş hash bu alana yazılmalıdır. İstek yapılırken gönderilmesi zorunludur.

  • text: Gönderilecek olan SMS metnini içerir. İstek yapılırken gönderilmesi zorunludur. URL encode işleminden geçirilmelidir.

İpucu

Eğer hazır bir panele entegrasyon yapmıyor veya kendi yazılımınıza sms entegrasyonu için bir panel yapıyorsanız "text" alanına gelen mesaj metniniz içinde url adresini bozabilecek karakterler içerebileceği için bu değerleri encode etmelisiniz.

Her yazılım dilinde bu encode işlemini yapan yerleşik fonksiyonlar mevcuttur.

&text=Encode edilmemiş mesaj metni örneği

#Encode işleminden sonra mesaj metni aşağıdaki şekilde gözükmeli
&text=Encode%20edilmemi%C5%9F%20mesaj%20metni%20%C3%B6rne%C4%9Fi

Daha detaylı bilgi için

  • receipents: Alıcının cep telefonu numarasını içerir. Numara formatı 5xxxxxxxxx şeklinde olmalıdır. Belirtilen mesaj metni için birden fazla alıcı tanımlanacaksa,numaralar virgül ile ayrılmalıdır. İstek yapılırken gönderilmesi zorunludur.

  • sender: iletimerkezi.com yönetim panelinden tanımlanmış ve iletimerkezi.com tarafından onaylanmış, maksimum 11 karakterden oluşan başlık bilgisidir. Gönderilen mesaj, alıcıya bu parametre ile belirtilen başlık ile yollanır. İstek yapılırken gönderilmesi zorunludur. URL encode işleminden geçirilmelidir.

  • iys: Mesajın, İleti Yönetim Sistemi (İYS) üzerinden sorgulanıp sorgulanmayacağını ifade eder. Eğer bu değeri 1(true) olarak gönderirseniz mesajlarınız İYS üzerinden sorgulanır, 0(false) olarak gönderirseniz sorgulanmaz. İstek yapılırken gönderilmesi zorunludur.

İpucu

Ticari mesaj gönderiyorsanız bu değer yasal olarak 1 olmalıdır. Aksi durumda cezai işlem uygulanabilir.

İYS hakkında detaylı bilgi için tıklayınız.

  • iysList: İleti Yönetim Sistemi (İYS) üzerinden sorgulanmasını istediğiniz listeyi ifade eder. iys değerini 1 olarak gönderdiyseniz yani mesajınızın İYS üzerinden sorgulanmasını istiyorsanız, iysList değerinin BIREYSEL veya TACIR olarak gönderilmesi zorunludur. iys değerini 0 olarak gönderiyorsanız bu alan dikkate alınmayacaktır.

Örnek İstek

https://api.iletimerkezi.com/v1/send-sms/get/?key=3ea65b1e8baxxxx&hash=XXXX&text=Lorem%20ipsum%20dolor%20sit%20amet&receipents=5301234569,5301234570&sender=APITEST&iys=1&iysList=BIREYSEL

Sunucu Yanıtı

<response>
<status>
<code></code>
<message></message>
</status>
<order>
<id></id>
</order>
</response>

Tanımlar

Sunucudan gelen yanıt her zaman response etiketi ile sarmalanmıştır. Bu etiketin, alt etiketlerinin tanımı aşağıdaki gibidir:

status

İşlem durumu ile ilgili bilgi içerir. Bu etiket ile döndürülen değerler aynı zamanda HTTP yanıtının başlık bilgisine bakılarak da elde edilebilir. Bu etiket, yapılan her istekte standart olarak döndürülür. Alt etiketleri aşağıdaki gibidir

  • code: İşlem durumunu belirten numerik değerdir.
  • message: İşlem durumu hakkında bilgi mesajı içerir.

order

İşlem başarılı olarak tamamlandıysa oluşturulan sipariş bilgisini içerir. İşlem başarısızsa bu etiket döndürülmez. order etiketi tekrarlanabilir bir etiket değildir. İstek başına yalnızca bir sipariş gönderilebilir. Alt etiketi aşağıdaki gibidir:

  • id: Siparişi ifade eden eşsiz numerik değerdir. "id" değerini kendi sistemlerinizde saklayarak, siparişin raporunu sorgularken, ileri tarihli bir gönderim yaptıysanız siparişi iptal ederken kullanabilirsiniz.

Hata Kodları

Eğer istek sonucu olumsuz ise sunucu tarafından size dönücek hata kodları ve mesajlar aşağıdaki gibidir.

codemessageAçıklama
401Üyelik bilgileri hatalıkey, hash etiketi içerisinde göndermiş olduğunuz bilgileri doğrulayamadığımızda bu hatayı veriyoruz, eğer hesabınızda sabit IP tanımladıysanız ve farklı bir IP üzerinden istek yapıyorsanız yine bu hatayı alırsınız.
402Bakiye yetersizEğer hesabınızdaki bakiye bu siparişi göndermeye yetmiyorsa bu hatayı veriyoruz.
450Gönderilen başlık kullanıma uygun değilsender etiketi ile göndermiş olduğunuz değer eğer hesabınızda onaylı değilse bu hatayı alırsınız, hesabınızda tanımlı olduğu şekilde göndermeniz gerekmektedir. Genellikle bu hatanın alınmasına sebep olan değişiklikler, küçük-büyük harf farkları veya ektra boşluk değerlerinin gönderilmesidir.
451Tekrar eden siparişEğer aynı mesaj metnini, aynı alıcılara 10dk içinde tekrar göndermek isterseniz sistem bu hatayı size döner, hem spam olmaması hemde yanlışlıkla aynı kişilere aynı mesajların iletilmemesi için. Böyle bir gönderim ihtiyacınız varsa mesaj metninin içine o anki saat ve dakikayı yazarak mesaj metnini farklılaştırabilirsiniz.
452Mesaj alıcıları hatalıreceipents etiketi ile göndermiş olduğunuz telefon numaraları eksik veya doğrulanamıyor ise bu hatayı veriyoruz. Aynı zamanda eğer mesaj atmak istediğiniz cep telefonu numarasının doğru olduğuna eminseniz, cep telefonu numarası eğer numara engelleme listenize eklediyseniz yine bu hatayı alabilirsiniz.
453Sipariş boyutu aşıldıtext etiketi ile göndermiş olduğunuz mesaj metni karakter kodlamanıza göre yedi(7) SMS uzunluğundan daha fazla ise bu hata geri döner.
454Mesaj metni boştext parametresinde göndermiş olduğunuz mesaj metni herhangi bir değer içermiyorsa mesajınız gönderilmez ve bu hata mesajı döner.

Örnek Başarılı Yanıt

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<message>İşlem Başarılı</message>
</status>
<order>
<id>323223</id>
</order>
</response>

Örnek Hatalı Yanıt

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>401</code>
<message>Üyelik bilgileri hatalı</message>
</status>
</response>