NETGSMSMS http://sms.netgsm.com.tr VER 5.6.0
GENEL UYARILAR: 1- Api ile sms göndermek için sms.netgsm.com.tr giriş yaptıktan sonra Kullanıcı Bilgileri / Api Talep menüsünden api talebinde bulununuz. Api ile ilgili teknik değişiklik ve gelişmelerden haberdar olmak için bu sayfadaki api yetkilisi bölümüne kodlama yapanın bilgilerini girmeniz gerekmektedir. Ayrıca yine bu sayf adan api kullanımına ip ile sınırlama getirebilirsiniz. 2- Mesaj başlığı kısmına kullanıcınıza tanımlı gönderici adlarından birini giriniz. 3- Api kullanarak bir dakika içinde en fazla 50 paket gönderebilirsiniz. Paketlerde telefon sınırı yoktur. 4-1 dakika içerisinde 3 kere hatalı sorguda bulunan IP, 1 saatliğine api ile hesap erişimi durdurulur. 5- Destek ve sorularınız için teknikdestek@netgsm.com.tr mail adresine mail gönderebilirsiniz. SMS Gönderim Yöntemleri 1- Get ile Gönderimi Adres http://api.netgsm.com.tr/bulkhttppost.asp Parametreler Alan Adı Boyut Tip Açıklama usercode Max.25 string Netgsm sistemine giriş yapmak için kullandığınız kullanıcı adı password Max.25 string Netgsm sistemine giriş yapmak için kullandığınız şifre gsmno Max.12 int Mesajın gönderileceği gsm numarasıdır.12 hanedir. Örn: 905051234567 message Max.1530 string Mesaj metnidir. Tarifenizdeki maksimum karakterden uzun olmamalıdır.standart maksimum karakter 459 dur. msgheader Max.11 string Mesajın gönderen kısmında görünecek olan gönderici adıdır. En az 3 en fazla 11 karakter olmamalıdır. startdate Max.12 date Mesajın gönderilmeye başlanacağı tarih (ddmmyyyyhhii) stopdate Max.12 date Mesajın geçerlilik süresinin bittiği tarih(ddmmyyyyhhii) Örnek Gönderim http://api.netgsm.com.tr/bulkhttppost.asp?usercode=deneme&password=1234& gsmno=5051234567,5441234568&message=testmesaji&msgheader=mesajbaslik& startdate=300120121721&stopdate=300120122321 Mesajın gönderimi sonucunda ekrana ileti yada hata verisi döner. İleti Durumları 00 123456 : Mesaj sorunsuz bir şekilde iletildi 01 123456 : Mesaj gönderim başlangıç tarihinde hata var. Sistem tarihi ile değiştirilip gönderildi. 02 123456 : Mesaj gönderim sonlandırılma tarihinde hata v ar.sistem tarihi ile değiştirilip gönderildi. Bitiş tarihi başlangıç tarihinden küçük girilmiş ise, sistem bitiş tarihine bulunduğu içinde bulunduğu tarihe 24 saat ekler. 00 123456 İleti veya Hata Durumu Mesaj ID Hata Durumları 10 : Telefon Numarası Hatalı 20 : Mesaj Metninde boş olmasından veya maksimum mesaj karakterini geçilmesi 30 : Kullanıcı bilgisi bulunamadı 40 : Geçersiz Mesaj Başlığı (başlık sisteme tanımlanmamış) 50 : Kullanıcının Kredisi Yok 60 : Telefon Numarası hiç tanımlanmamış 70 : Mesaj Başlığı hatalı
2-XML ile toplu gönderim i) 1 mesajı n adet kişiye gönderme ( 1:n ) Adres http://api.netgsm.com.tr/xmlbulkhttppost.asp Parametreler Alan Adı Boyut Tip Açıklama <company> Max.9 string Bu alan NETGSM olmalıdır. <usercode> Max.25 string NetGSM den alınan Kullanıcı Adı <password> Max.25 string netgsm.com.tr den alınan Kullanıcı şifresi <startdate> Max.12 date Mesajın gönderilmeye başlanacağı tarih (ddmmyyyyhhmm) <stopdate> Max.12 date Mesajın geçerlilik süresinin bittiği tarih(ddmmyyyyhhmm) <type> Max.3 string 1 mesaj N adet numaraya gönderilecek (1:n) <msgheader> Max.11 string Mesajın gönderen kısmında görünecek olan başlıktır. En az 3 en fazla 11 karakter olmamalıdır. <msg> Max. 1530 string Mesaj metnidir. Tarifenizdeki maksimum karakterden uzun olmamalıdır.standart maksimum karakter 459 dur. XML Parse işlemlerinde Türkçe karakterler ve özel işaretlerin sorun yaratmaması için, mesaj metni <![CDATA[Mesaj metni bu alanda olacak]]> tag ları içinde yer almadır. <no> Max.12 int Mesajın gönderileceği gsm numarasıdır. 12 hanedir. Örn: 05051234567 Takip eden numaralar da <no> tag ları içine girilir. Örnek Şablon <?xml version="1.0" encoding="iso-8859-9"?> <mainbody> <header> <company>netgsm</company> <usercode>kullaniciadi</usercode> <password>sifre</password> <startdate>151220041828</startdate> <stopdate>171220041425</stopdate> <type>1:n</type> <msgheader>mesajbaslik</msgheader> </header> <body> <msg><![cdata[deneme Mesajı]]></msg> <no>905551234567</no> <no>905551234567</no> </body> </mainbody>
ii) n adet mesajı n adet kişiye gönderme (n:n) Adres http://api.netgsm.com.tr/xmlbulkhttppost.asp Parametreler Alan Adı Boyut Tip Açıklama <company> Max.9 string Bu alan NETGSM olmalıdır. <usercode> Max.25 string NetGSM den alınan Kullanıcı Adı <password> Max.25 string netgsm.com.tr den alınan Kullanıcı şifresi <startdate> Max.12 date Mesajın gönderilmeye başlanacağı tarih (ddmmyyyyhhii) <stopdate> Max.12 date Mesajın geçerlilik süresinin bittiği tarih(ddmmyyyyhhii) <type> Max.3 string N mesaj N adet numaraya gönderilecek (n:n) <msgheader> Max.11 string Mesajın gönderen kısmında görünecek olan başlıktır. En az 3 en fazla 11 karakter olmamalıdır. <msg> Max. string Mesaj metnidir. Tarifenizdeki maksimum karakterden uzun 1530 olmamalıdır.standart maksimum karakter 459 dur. XML Parse işlemlerinde Türkçe karakterler v e özel işaretlerin sorun yaratm aması için, mesaj metni <![CDATA[Mesaj metni bu alanda olacak]]> tagları içinde yer almadır <no> Max.12 int Mesajın gönderileceği gsm numarasıdır. 12 hanedir. Örn: 05051234567 Takip eden numaralar da <no> tag ları içine girilir. <mp> - - Mesajı ve telefonu gruplayan parametredir Örnek Şablon <?xml version="1.0" encoding="iso-8859-9"?> <mainbody> <header> <company>netgsm</company> <usercode>kullaniciadi</usercode> <password>sifre</password> <startdate>151220041828</startdate> <stopdate>171220041425</stopdate> <type>n:n</type> <msgheader>mesajbaslik</msgheader> </header> <body> <mp><msg><![cdata[mesaj1]]></msg><no>905551234567</no></mp> <mp><msg><![cdata[mesaj2]]></msg><no>905551234568</no></mp> </body> </mainbody> Mesajın gönderimi sonucunda ekrana ileti yada hata verisi döner. İleti Durumları 00 123456 : Mesaj sorunsuz bir şekilde iletildi 01 123456 : Mesaj gönderim başlangıç tarihinde hata var. Sistem tarihi ile değişitirilip gönderildi. 02 123456 : Mesaj gönderim sonlandırılma tarihinde hata v ar. Sistem tarihi ile değiştirilip gönderildi. Bitiş tarihi başlangıç tarihinden küçük girilmiş ise, sistem bitiş tarihine bulunduğu içinde bulunduğu tarihe 24 saat ekler. 00 123456 İleti veya Hata Durumu Mesaj ID
Hata Durumları 20 : Mesaj Metninde problemden dolayı gönderilemedi 30 : Geçersiz Kullanıcı adı veya şifresi. 40 : Geçersiz Mesaj Başlığı 50 : Kullanıcının yeterli kredisi yok 70 : Geçersiz XML formatı 90 : Mesaj sistem tarafından kabul edilmedi. Daha sonra tekrar deneyin. 100 : Sistem Hatası oluştu sistem yöneticinizi arayın 3- Gelen SMS Adres http://api.netgsm.com.tr/xmlgelenmesaj.asp <?xml version='1.0'?> <mainbody> <header> <usercode>kullaniciadi</usercode> <password>sifre</password> <stip>1</stip> </header> </mainbody> Sorgu sonucu; 5xxxxxxxxx Gelen Mesaj 21.09.2012 10:02:45 Gönderen TelefonNo Mesaj Mesajın geldiği Tarih Hata Durumu 30 : Geçersiz Kullanıcı adı ve şifre RAPORLAR 1-Kredi Sorgulama Adres http://api.netgsm.com.tr/get_kredi.asp Parametreler Alan Adı Boyut Tip Açıklama usercode Max.25 string NetGSM den alınan Kullanıcı Adı password Max.25 string netgsm.com.tr den alınan Kullanıcı Şifresi Örnek Adres http://api.netgsm.com.tr/get_kredi.asp?usercode=kullaniciadi&password=sifre Sorgu sonucu 00 dan sonraki boşluk kullanıcının kredi miktarı verilir. 00 1,905 İleti veya Hata Durumu Hata Durumu 30 : Geçersiz Kullanıcı adı ve şifre. Kredi Miktarı 2-Mesaj ID göre Raporlama İleti durumuna göre adetlerinin Sorgulanması Toplu SMS gönderimlerinde Herbir Grup SMS e ait BulkID e göre gönderilen smslerin durumunu alabilmek
için aşağıdaki url ye GET methodu ile parametre göndermeniz gerekmektedir. Adres http://api.netgsm.com.tr/httpbulkrapor.asp Parametreler Alan Adı Boyut Tip Açıklama usercode Max.25 string NetGSM den alınan Kullanıcı Adı password Max.25 string netgsm.com.tr den alınan Kullanıcı şifresi bulkid int Sorgulanacak olan Toplu SMS e ait Bulk ID si Type Max.1 int Sorgulama tipini belirlemek için kullanılır. 0 : Tek bulkid ye göre sorgulama yapar. 1 : Birden çok bulkid ye göre sorgulama yapar. (Not bu durumda bulkid parametresi 43234,53453,54332,.. gibi yazılır) 2 : Tarih aralığında sorgu yapabilmek için kullanılır. Not: parametrenin bu değerinde bulkid parametresine girilen değer dikkate alınmaz. bastar Max.12 date Mesajın gönderilmeye başlanacağı tarih (ddmmyyyyhhmm) bittar Max.12 date Mesajın geçerlilik süresinin bittiği tarih(ddmmyyyyhhmm) mbaslik Max.11 string Mesajın gönderen kısmında görünecek olan başlıktır. En az 3 en fazla 11 karakter olmamalıdır. status Max.1 int 0 : İletilmeyi Bekleyenler 1 : İletilmiş Olanlar 2 : Zaman aşımına uğramış olanlar 3 : Red Edilmiş olanlar 4 : Hatalı veya kısıtlı numara 11 : Operatör tarafından kabul edilmemiş olanlar. 12 : Gönderim hatası olanlar. 13 : Mükerrer olanlar. 100: Tüm mesaj durumları version Max.1 int 0: olursa veya hiç gönderilmezse status değerlerindeki 11,12,13 durumları 2 (Zaman aşımına uğramış) olarak kabul edilir. 1: Gönderilirse status değerleri aynen geçerlidir. Örnek Adres http://api.netgsm.com.tr/httpbulkrapor.asp? usercode=xxxx&password=yyyy&bulkid=32443&type=0&status=0 Hata olmadığı durumda dönen cevap 905550000000 905550000001 905550000002 olur. http://api.netgsm.com.tr/xmlget_post/httpbulkrapor.asp? usercode=xxxx&password=yyyy&bulkid=32443&type=1&status=0 Eğer type=1 veya type=2 ise 53545 905550000000 0 53545 905550000001 1 53545 905550000002 2 53545 0505550000000 0 Mesaj ID Cep Telefon Mesaj Durumu İlk rakam mesajid, ikinci rakam telefon numarası, üçüncü rakam status durumudur. Hata Durumları 30 : Kullanıcı Kaydı bulunamadı 60 : Sorgulama sonucunda kayıt bulunamadı Not : Bütün numaralar birbirlerinden <BR> kodu ile ayrılmıştır.
C# ÖRNEK FONKSIYON : C# da yazılmış api örneğimize : http://api.netgsm.com.tr/apiornekleri/c_netgsm.zip adresinden ulaşabilirsiniz. private string XMLPOST(string PostAddress,string xmldata) { try { WebClient wupload = new WebClient(); Byte[] bpostarray = Encoding.ASCII.GetBytes(xmlData); Byte[] bresponse = wupload.uploaddata(postaddress,"post",bpostarray); Char[] sreturnchars = Encoding.ASCII.GetChars(bResponse); string swebpage = new string(sreturnchars); return swebpage; } catch { return "-1"; } } ASP ÖRNEK FONKSIYON : ASP de yazılmış api örneğimize : http://api.netgsm.com.tr/apiornekleri/asp_netgsm.zip adresinden ulaşabilirsiniz. Function XMLPOST(ByVal PostAddress, ByVal xmldata) On Error Resume Next Set objxmlhttp = Server.CreateObject("Microsoft.XMLHTTP") objxmlhttp.open "POST",PostAddress,False objxmlhttp.send xmldata if Err then Err.Clear XMLPOST = "hata" Set objxmlhttp = Nothing Exit Function else XMLPOST = objxmlhttp.responsetext Set objxmlhttp = Nothing end if End Function VB.NET ÖRNEK FONKSIYON :.Private Function XMLPOST(ByVal PostAddress As String, ByVal xmldata As String) As String Try Dim wupload As Net.WebClient = New System.Net.WebClient Dim bpostarray As Byte() = Encoding.ASCII.GetBytes(xmlData) Dim bresponse As Byte() = wupload.uploaddata(postaddress, "POST", bpostarray) Dim swebpage As String = Encoding.ASCII.GetChars(bResponse) XMLPOST = swebpage Catch ex As Exception XMLPOST = "" End Try End Function
JAVA ÖRNEK FONKSIYON : JAVA da yazılmış api örneğimize : http://api.netgsm.com.tr/apiornekleri/java_netgsm.zip adresinden ulaşabilirsiniz. import java.io.*; import java.net.*; public class XMLPOST { public static void main(string[] args) { System.out.println("SMS Gönderiliyor.."); try { URL u = new URL("https://api.netgsm.com.tr/xmlbulkhttppost.asp"); } URLConnection uc = u.openconnection(); HttpURLConnection connection = (HttpURLConnection) uc; connection.setdooutput(true); connection.setdoinput(true); connection.setrequestmethod("post"); OutputStream out = connection.getoutputstream(); OutputStreamWriter wout = new OutputStreamWriter(out, "UTF-8"); wout.write("<?xml version='1.0' encoding='iso-8859-9'?>"+ " <mainbody>"+ " <header>"+ "<company>netgsm</company>"+ "<usercode>kullanici_adi</usercode>"+ " <password>sifre</password>"+ " <startdate></startdate>"+ " <stopdate></stopdate>"+ " <type>1:n</type>"+ " <msgheader>baslik</msgheader>"+ " </header>"+ " <body>"+ " <msg><![cdata[deneme Mesaji]]></msg>"+ " <no>905001234567</no>"+ " </body>"+ " </mainbody>"); wout.flush(); out.close(); InputStream in = connection.getinputstream(); int c; while ((c = in.read())!= -1) System.out.write(c); System.out.println(); in.close(); out.close(); connection.disconnect(); } catch (IOException e) { System.err.println(e); e.printstacktrace(); }
PHP ÖRNEK FONKSIYON : PHP de yazılmış api örneğimize : http://api.netgsm.com.tr/apiornekleri/php_netgsm.zip adresinden ulaşabilirsiniz. function XMLPOST($PostAddress,$xmlData){ $ch = curl_init(); curl_setopt($ch, CURLOPT_URL,$PostAddress); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST,1); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER,0); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt( $ch, CURLOPT_HTTPHEADER, Array("Content-Type: text/xml")); curl_setopt($ch, CURLOPT_TIMEOUT, 30); curl_setopt($ch, CURLOPT_POSTFIELDS, $xmldata); $result = curl_exec($ch); return $result; VB ÖRNEK FONKSIYON : VB de yazılmış api örneğimize : http://api.netgsm.com.tr/apiornekleri/vb_netgsm.zip adresinden ulaşabilirsiniz. Private Function XMLPOST(ByVal PostAddress As String, ByVal xmldata As String) As String On Error GoTo hata_kontrol Dim XMLSender As New MSXML.XMLHTTPRequest XMLSender.open "POST", PostAddress, False XMLSender.send xmldata XMLPOST = XMLSender.responseText Exit Function hata_kontrol: XMLPOST = "" End Function } DELPHI ÖRNEK FONKSIYON: DELPHI de yazılmış api örneğimize : http://api.netgsm.com.tr/apiornekleri/delphi_netgsm.zip adresinden ulaşabilirsiniz. //uses IdHTTP function xmlpost(url, postdata: string): String; //Dikkat!!! indy bu component 'i ssl desteği vermediği için url parametresi http:// ile başlamalı var IdHTTP1: TIdHTTP; str1:tstringlist; begin try try IdHTTP1:=TIdHTTP.Create(nil); str1:=tstringlist.create; str1.text:=postdata; result:=idhttp1.post(url, str1); except end; finally FreeAndNil(str1); FreeAndNil(IdHTTP1); end; end;
NETGSM SOAP WEBSERVİSİ Servis URL : http://soap.netgsm.com.tr:8080/sms_webservis/sms?wsdl Geliştirme yaptığımız her dildeki programınıza kolaylıkla entegre edebilirsiniz. JAVA Örneği: Java örneğini için NetBeans IDE 7.1.1 kullanılmıştır. Gerekli Java sürümü de kurulu olması gerekir. 1- File sekmesinden New Project > Java > Java Application seçilir Next e basılır. 2- Project Name: proje adı yazılır ve Finish e basılır.
3-Oluşturulan proje dosyamıza sağ tıklayıp New > Web Service Client seçilir. 4-Gelen pencerede WSDL URL seçip yukarıda belirtilen url yi yazınız.
5-Web servis sunucusundan gerekli dosyalar aşağıdaki gibi compile edilmiş olmalıdır. 6-SMS servisin altında bulunan prosedür sürükleyip çalışma alanına atarak prosedürleri kullanabilirsiniz.
7. Aşağıda Java örneği bulunmaktadır. String donen_deger=""; //--------------------------1n sms gönderimi------------------------------------------- List < String > mylist1n = new ArrayList < String >() ; mylist1n.add ( "5050000000" ); donen_deger=smsgonder1n( "kullanici_adi", "sifre", null, "baslik", "deneme mesaji", mylist1n, //telefon array "TR", //dil kodlaması "210520121215", //başlama tarihi (ileri tarihli sms gönderilecekse) "210520121245");//bitiş tarihi (ileri tarihli sms gönderilecekse) System.out.println("1n sms durum="+donen_deger); //--------------------------Nn sms gönderimi------------------------------------------- List < String > mylistnn_tel = new ArrayList < String >() ; mylistnn_tel.add ( "5050000000" ); mylistnn_tel.add ( "5420000000" ); mylistnn_tel.add ( "5320000000" ); List < String > mylistnn_msg = new ArrayList < String >() ; mylistnn_msg.add ( " webservis deneme smsi 1" ); mylistnn_msg.add ( " webservis deneme smsi 2" ); mylistnn_msg.add ( " webservis deneme smsi 3" ); donen_deger=smsgondernn( "kullanici_adi", "sifre", null, "baslik", mylistnn_msg, //mesaj array mylistnn_tel, //telefon array "TR", //Dil kodlama "210520121215", //başlama tarihi (ileri tarihli sms gönderilecekse) "210520121245");//bitiş tarihi (ileri tarihli sms gönderilecekse) System.out.println("Nn sms durum="+donen_deger); //--------------------------Kredi Sorgula------------------------------------------- donen_deger=kredi( "kullanici_adi", "sifre"); System.out.println("kredi durum="+donen_deger); // --------------------------Rapor Sorgula------------------------------------------- donen_deger=rapor("kullanici_adi", "sifre", "bulkid", 1, 0); System.out.println("rapor durum="+donen_deger); Örneği indirebileceğiniz adres; http://api.netgsm.com.tr/netgsm_soap_client.zip Veri Tipi Açıklamaları
Veri Açıklama Key Alanı Servis Methodu Kullanıcı Adı username Sisteme kayıtlı kullanıcı adı Şifre password Sisteme kayıtlı şifre Başlık header Sistemde kayıtlı en az 3 en fazla 11 olan mesaj başlığı Mesaj içeriği msg, msg[] SMS metninin yer alacağı alandır. Nn sms gönderimlerinde array olarak gönderilmeli. Sms gönderilecek telefonlar gsm[] SMS in gideceği numaraları temsil eder array gönderilmeli Dil Kodlama encoding Türkçe karakter desteği isteniyorsa bu alana TR girilmeli. Kanal Seçimi company _200A011A_70 girildiğinde sms başlığında abone numarası gidecektir. Başlama Tarihi startdate İleri tarihli sms gönderildiğinde başlangıç tarihi Bitiş Tarihi stopdate İleri tarihli sms gönderildiğinde bitiş tarihi Görev Numarası bulkid Sms paketi başarılı bir şekilde iletildi ise geriye dönen görev numarası SMS durumu status Rapor prosedüründe istenilen durumu temsil eder. Tablo-3 de rapor durumları yer almaktadır. Versiyon version 1 olarak gönderildiğinde tüm durumlar geriye döner. Status durumu dikkate alınmaz. 0 olduğunda versiyon dikkate alınamaz. Tablo-1 Dönen Cevaplar Durum Açıklama 70 Zorunlu alanlarda (kullanıcı adı, şifre, başlık, mesaj ve telefon) eksik yada hatalı olması 30 Kullanıcı adı veya şifre hatalı 40 Geçersiz başlık 50 Yetersiz bakiye 60 İlgili BulkID rapor kaydı bulunamadı 90 Kanal kapalı 20 Mesaj uzunluğu belirlenen sınırı aştı 100-101 Sistem hatası Tablo-2 Rapor Durumları Durum Açıklama 0 İletilmeyi Bekleyenler 1 İletilmiş Olanlar 2 Zaman aşımına uğramış olanlar 3 Red edilmiş olanlar 4 Hatalı veya kısıtlı numara 11 Operatör tarafından kabul edilmemiş olanlar 12 Gönderim hatası olanlar 13 Mükerrer olanlar Tablo-3