Merhaba Güncel API Dokümantasyonu.

Transkript

1 Merhaba Güncel API Dokümantasyonu.

2 XML ile SMS Gönderimi XML ile SMS Gönderimi azami kişiye kadar yapılabilmektedir adet üzerindeki gönderimlerinizi loop ederek er adetlik paketler halinde göndermeniz gerekmektedir. XML ile SMS Gönderimi için örnek XML Yapısı aşağıdaki şekildedir. <SMS> <mesaj> <baslik>demo</baslik> <metin>xml Api ile sms gonderimi...</metin> <alicilar> , , </alicilar> <tarih>yyyy-mm-dd HH:MM:SS</tarih> </mesaj> <karaliste>kendi genel</karaliste> <izin_link>true false</izin_link> <izin_telefon>true false</izin_telefon> </SMS> Not: <tarih></tarih> taglarını boş bırakırsanız mesaj hemen gider. İleri bir tarihte gitmesini isterseniz yukarıda belirtilen formatta göndermeniz gerekmektedir. Türkçe Karakter Desteği için : Normal Gönderim için : sifre : DakikSMS de kayıtlı olan şifrenizdir. baslik : Mesaj gönderiminin hangi başlık üzerinden yapılacağını belirtir.azami 11 karakter olabilir. metin : Mesaj metnini belirtir. alicilar : Mesajın gönderileceği numaraları belirtir.başına 0 konulmadan girilmelidir.birden fazla kişiye mesaj göndermek için araya virgül (,) konularak yazılmalıdır. tarih : Boş bırakılması durumunda mesaj hemen gider,ileri bir tarihte gönderim için 19 karakter olacak şekilde yukarıdaki formata uygun şekilde girilmelidir. karaliste : Sistem üzerinde bulunan karalisteyi kullanarak mesaj göndermenizi sağlar. 2 parametre almaktadır. Bu parametreler, Genel(Genel olarak kullanılan karalisteyi kontrol eder.) veya Kendi(size ait olan kara listenizi kontrol eder.) olarak kullanılabilir. Dönen Sonuçlar : Mesaj gönderiminin başarılı olması durumunda OK MesajID şeklinde bir sonuç döner. OK kısmı herzaman sabittir. işaretinden sonraki kısım değişkendir. Mesaj gönderiminin başarısız olması durumunda ERR ile başlayan ve türkçe açıklama içeren hata mesajları döner.err kısmı her zaman sabittir.

3 XML ile Hitaplı (Parametrik) SMS Gönderimi XML ile SMS Gönderimi azami kişiye kadar yapılabilmektedir adet üzerindeki gönderimlerinizi loop ederek er adetlik paketler halinde göndermeniz gerekmektedir. XML ile Hitaplı (Parametrik) SMS Gönderimi için örnek XML Yapısı aşağıdaki şekildedir. <SMS> <baslik>demo</baslik> <mesaj> <metin>sayin Veli Dogan, borcunuz 15TL dir.</metin> <alici> </alici> </mesaj> <mesaj> <metin>sayin Hasan Dogan, borcunuz 20TL dir.</metin> <alici> </alici> </mesaj>... <tarih>yyyy-mm-dd HH:MM:SS</tarih> <karaliste>kendi genel</karaliste> <izin_link>true false</izin_link> <izin_telefon>true false</izin_telefon> </SMS> Not: <tarih></tarih> taglarını boş bırakırsanız mesaj hemen gider. İleri bir tarihte gitmesini isterseniz yukarıda belirtilen formatta göndermeniz gerekmektedir. Türkçe Karakter Desteği için : Normal Gönderim için : sifre : DakikSMS d e kayıtlı olan şifrenizdir. baslik : Mesaj gönderiminin hangi başlık üzerinden yapılacağını belirtir.azami 11 karakter olabilir. metin : Mesaj metnini belirtir. alicilar : Mesajın gönderileceği numaraları belirtir.başına 0 konulmadan girilmelidir.birden fazla kişiye mesaj göndermek için araya virgül (,) konularak yazılmalıdır. tarih : Boş bırakılması durumunda mesaj hemen gider,ileri bir tarihte gönderim için 19 karakter olacak şekilde yukarıdaki formata uygun şekilde girilmelidir. karaliste : Sistem üzerinde bulunan karalisteyi kullanarak mesaj göndermenizi sağlar. 2 parametre almaktadır. Bu parametreler, Genel(Genel olarak kullanılan karalisteyi kontrol eder.) veya Kendi(size ait olan kara listenizi kontrol eder.) olarak kullanılabilir. Dönen Sonuçlar : Mesaj gönderiminin başarılı olması durumunda OK MesajID şeklinde bir sonuç döner. OK kısmı herzaman sabittir. işaretinden sonraki kısım değişkendir. Mesaj gönderiminin başarısız olması durumunda ERR ile başlayan ve türkçe açıklama içeren hata mesajları döner.err kısmı her zaman sabittir.

4 XML ile Rapor Sorgulama (ID ye Göre) Bu method ile gönderimlerinize ait raporlarınızı anında sorgulayabilirsiniz XML Rapor Sorgulama için örnek XML Yapısı aşağıdaki şekildedir. <RAPOR> <kullanici>kullanıcı adı</kullanici> <rapor> <raporid>mesaj gonderimi sirasinda gelen ok cevapli id...</raporid> </rapor> </RAPOR> sifre : DakikSMS d e kayıtlı olan şifrenizdir. raporid: Mesaj gönderiminden dönen mesaj id sidir. Dönen XML Yapısı: <SONUC> <BEKLEYEN> , </BEKLEYEN> <ILETILEN> </ILETILEN> <HATALI> </HATALI> </SONUC>

5 XML ile Rapor Sorgulama (Tüm Raporlar) Bu method ile üyeliğinizin başından bu güne kadar gönderdiğiniz tüm raporlarınızın ID lerini elde edebilirsiniz. XML Rapor Sorgulama için örnek XML Yapısı aşağıdaki şekildedir. <RAPOR> </RAPOR> sifre : DakikSMS de kayıtlı olan şifrenizdir. Dönen XML Yapısı: XML tagları içerisinde virgül ile ayrılmış şekilde rapor ID lerinizi döndürür. <SONUC>123456,987654,159753</SONUC>

6 XML ile Bakiye Sorgulama Bu method ile kredilerinizi anında sorgulayabilirsiniz XML Bakiye Sorgulama için örnek XML Yapısı aşağıdaki şekildedir. <RAPOR> <etiket>xml</etiket> </RAPOR> sifre : DakikSMS de kayıtlı olan şifrenizdir. etiket : XML veya TEXT olarak belirleyebilirsiniz. Dönen XML Yapısı: <etiket> TEXT olarak belirlendiğinde: String şeklinde döner. XML tag içermez. numerik(0) alphanumeric(999) <etiket> XML olarak belirlendiğinde: XML tag ile döner. <bakiye> <bakiye>

7 URL Kısaltma Modülü Bu method ile uzun linklerinizi kısaltarak mesajlarınızın içerisinde veya dilediğiniz herhangi bir yerde rahatlıkla kullanabilirsiniz. URL kısaltma servisi için örnek XML Yapısı aşağıdaki şekildedir. <id>kisa URL ID</id> <url>url</url> <islem>işlem</islem> sifre : DakikSMS de kayıtlı olan şifrenizdir. url : Kısaltmak istediğiniz adresinizdir. islem : Yapılacak işlemi belirtir. ekle : Yeni bir adres kısaltmanızı sağlar. duzenle : Kısaltılmış bir adresi düzenlemenizi sağlar. <id> Etkiketi zorunludur. listele : Kısaltılmış tüm linklerin listesini döndürür. sil : Kısaltılmış bir adresin silinmesini sağlar. <id> Etkiketi zorunludur. Dönen XML Yapısı: İŞLEM : EKLE OK URL ID KISALTILMIŞ URL ADRESİ İŞLEM : DUZENLE OK URL duzenlendi. İŞLEM : SİL OK URL Silindi. İŞLEM : LİSTELE <XML> <RECORD> <ID>URL ID</ID> <URL>ORJİNAL URL</URL> <SHORT>KISALTILMIŞ URL</SHORT> <HIT>TIKLANMA SAYISI</HIT> <DATE>EKLENME TARİHİ</DATE> </RECORD>... </XML>

8 Görüşmek üzere. SAZAK GSM Haberleşme Teknolojileri Ltd. Şti Sokak No 8 Suat Manisalı İş Merkezi Kat 7 Çankaya / İZMİR SAZAK GSM Haberleşme Teknolojileri Ltd. Şti. - Ankara Ofisi Akpınar Mah. 849 Cadde 20/17 Çankaya / ANKARA SAZAK International Inc. 910 Foulk Road Suite 201 Wilmington, Delaware / USA Çağrı Merkezi Pazar günü saat 12:00' den itibaren hizmet verilmektedir. E-Posta İle İletişim Genel Konular Teknik Destek Muhasebe ve Finansman info@dakiksms.com teknik@dakiksms.com muhasebe@dakiksms.com