3G Sms&MMS GateWay Xml Interface

Transkript

1 3G Sms&MMS GateWay Xml Interface

2 İÇİNDEKİLER İÇİNDEKİLER... 2 WEB SERVIS API YE GİRİŞ... 4 AYNI MESAJIN ÇOK NUMARAYA GÖNDERİLMESİ... 6 TANIMI... 6 ÖRNEK XML... 6 XML ENVELOP AÇIKLAMALARI... 7 RESPONSE CEVAP AÇIKLAMALARI... 7 FARKLI MESAJLARIN FARLI NUMARALARA YOLLANMASI... 8 TANIMI... 8 ÖRNEK XML... 8 XML ENVELOP AÇIKLAMALARI... 9 RESPONSE CEVAP AÇIKLAMALARI... 9 AYNI MESAJIN ÇOKLU OLARAK TC KİMLİK NUMARASINA GÖNDERİLMESİ TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI FARKLI MESAJLARIN FARLI TC KİMLİK NUMARALARINA YOLLANMASI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI UZUN MESAJLARIN (CONCAT) TOPLU GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI UZUN MESAJLARIN (CONCAT) FARLI NUMARALARA YOLLANMASI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU BINARY SMS GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI BINARY SMSLERIN FARLI NUMARALARA YOLLANMASI TANIMI

3 ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU LOGO GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU MMS GÖNDERİMİ ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU WAPPUSH GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU SESLI MESAJ GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU BROSUR GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU VİDEO GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU MELODI GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI TOPLU VCARD GONDERIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI RESPONSE CEVAP AÇIKLAMALARI DETAY RAPOR ALIMI TANIMI ÖRNEK XML XML ENVELOP AÇIKLAMALARI

4 NUMARA DURUM KODLARI RAPOR ALIMINDA ALINABILECEK HATA KODLARI ÖRNEK RAPOR ORIGINATOR SORGULAMA TANIMI ÖRNEK XML ÖRNEK RESPONSE ORIGINATOR SORGULAMADA ALINABILECEK HATA KODLARI KREDİ SORGULAMA TANIMI ÖRNEK XML ÖRNEK RESPONSE ORIGINATOR SORGULAMADA ALINABILECEK HATA KODLARI TANITIM Bu döküman 3g Bilişim üzerinden Sms işlemleri kullanmak isteyen portal sahiplerinin WEB SERVIS kullanarak bunu nasıl yapacağını açıklar. WEB SERVIS API YE GİRİŞ Bu API WEB SERVIS kullanan uygulamalar için geliştirilmiştir. WEB SERVIS istekleri 3g Bilişim sunucusu tarafından karşılanacaktır. API yi kullanabilmek için sitesinden kullanıcı tanımlamış olmanız gerekir. 4

5 GATEWAY ORTAMI GENEL TANIMI 3 G Bilişim, yazılım geliştiren firmaların kullanabilecekleri iki çeşit sms gönderme yöntemi sağlanmaktadır. Aynı mesajın çok numaraya gönderilmesi, Farklı mesajların farklı numaralara gönderilmesi Her iki yöntemde de mesajlar XML Envelope u olarak gönderilmekte ve aynı raporlama uygulaması ile sonuçları alınmaktadır. Post edilen ASP ve DLL uygulamaları, 128 bit Thawte SSL sertifakası ile desteklenmiştir. Post edilme esnasında sertifika ile ilgili bir sıkıntı yaşanması durumunda:https yerine http metodu da kullanılabilir. GATEWAY HATA KODLARI 00 Kullanıcı Bilgileri Boş 01 Kullanıcı Bilgileri Hatalı 02 Hesap Kapalı 03 Kontör Hatası 04 Bayi Kodunuz Hatalı 05 Originator Bilginiz Hatalı 06 Yapılan İşlem İçin Yetkiniz Yok 10 Geçersiz IP Adresi 14 Mesaj Metni Girilmemiş 15 GSM Numarası Girilmemiş 20 Rapor Hazır Değil 27 Aylık Atım Limitiniz Yetersiz 100 XML Hatası 5

6 AYNI MESAJIN ÇOK NUMARAYA GÖNDERİLMESİ Tanımı Bu Yöntemde amaç, tek bir mesaj metninin farklı numaralara yollanabilmesidir. Bu yöntemde kullanılacak olan XML Formatı örnek xml bölümünde gösterilmektedir. Xml Paketi içerisinde yukarıda örneği verilen respose bilgileri kullanılmıştır. Sadece version bilgisi xml paketinin,hangi programdan ve hangi versiondan geldiği bilgilerinin arşivlerde tutulması amacıyla alınacaktır. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody> <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>1</Type> <Developer></Developer> <Originator><![CDATA[TEST]]></Originator > <Version>xVer.4.0</Version> <Mesgbody><![test mesajıdır]]></mesgbody> <Numbers> , </Numbers> <SDate></SDate> <EDate></EDate> </MainmsgBody> 6

7 Xml Envelop Açıklamaları Username Bayiniz tarafındam sağlanacak kullanıcı adı Password Kullanıcı Şifreniz CompanyCode Bayiniz Tarafından verilen kod MesgBody 160 karakter olacak şekilde oluşturulan mesaj metni Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 7

8 FARKLI MESAJLARIN FARLI NUMARALARA YOLLANMASI Tanımı Bu yöntemde amaç farklı numaralara farklı mesajların aynı anda yollanabilmesidir.örneğin herbir müşteriye farklı ödeme tutarlarının göndermesi gibi.bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody> <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>1</Type> <Developer>1521</Developer> <Version>xVer.2.0</Version> <Originator><![CDATA[TEST]]></Originator> <Messages> <Message> <Mesgbody> <![CDATA[ODEME TUTARINIZ 123 TLDIR.]]></Mesgbody> <Number> </Number> <SDate></SDate> <EDate></EDate> </Message> <Message> <Msgbody><![CDATA[ ODEME TUTARINIZ 225 TL DIR.]]></Msgbody> <Number> </Number> <SDate></SDate> <EDate></EDate> </Message> </Messages> </MainmsgBody> 8

9 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody 160 karakter olacak şekilde oluşturulan mesaj metni. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 9

10 AYNI MESAJIN ÇOKLU OLARAK TC KİMLİK NUMARASINA GÖNDERİLMESİ Tanımı Bu Yöntemde amaç, tek bir mesaj metninin farklı tc kimlik numaralarına yollanabilmesidir. Bu yöntemde kullanılacak olan XML Formatı örnek xml bölümünde gösterilmektedir. Xml Paketi içerisinde yukarıda örneği verilen respose bilgileri kullanılmıştır. Sadece version bilgisi xml paketinin,hangi programdan ve hangi versiondan geldiği bilgilerinin arşivlerde tutulması amacıyla alınacaktır. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody > <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>10</Type> <Developer></Developer> <Originator><![CDATA[TEST]]></Originator > <Version>xVer.4.0</Version> <Mesgbody><![CDATA[test mesajıdır]]></mesgbody> <Numbers>295., 296.</Numbers> <SDate></SDate> <EDate></EDate> </MainmsgBody> 10

11 Xml Envelop Açıklamaları Username Bayiniz tarafındam sağlanacak kullanıcı adı Password Kullanıcı Şifreniz CompanyCode Bayiniz Tarafından verilen kod MesgBody 160 karakter olacak şekilde oluşturulan mesaj metni Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers 11 Karakterden oluşan T.C. Kimlik Numarası SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 11

12 FARKLI MESAJLARIN FARLI TC KİMLİK NUMARALARINA YOLLANMASI Tanımı Bu yöntemde amaç farklı tc kimlik numaralarının farklı mesajların aynı anda yollanabilmesidir.örneğin herbir müşteriye farklı ödeme tutarlarının göndermesi gibi.bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody> <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>10</Type> <Developer>1521</Developer> <Version>xVer.2.0</Version> <Originator><![CDATA[TEST]]></Originator> <Messages> <Message> <Mesgbody><![CDATA[ ODEME TUTARINIZ 123 TLDIR.]]></Mesgbody> <Number>295..</Number> <SDate></SDate> <EDate></EDate> </Message> <Message> <Msgbody> <![CDATA[ODEME TUTARINIZ 225 TL DIR.]]></Msgbody> <Number>296..</Number> <SDate></SDate> <EDate></EDate> </Message> </Messages> </MainmsgBody> 12

13 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody 160 karakter olacak şekilde oluşturulan mesaj metni. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers 11 Karakterden oluşan T.C. Kimlik Numarası SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 13

14 UZUN MESAJLARIN (CONCAT) TOPLU GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya aynı anda gönderilmesidir.bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody> <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>5</Type> <Developer>1521</Developer> <Version>xVer.2.0</Version> <Originator><![CDATA[TEST]]></Originator> <Mesgbody> <![CDATA[ODEME TUTARINIZ 123 TLDIR.]]></Mesgbody> <Number> , </Number> <SDate></SDate> <EDate></EDate> </MainmsgBody> 14

16 UZUN MESAJLARIN (CONCAT) FARLI NUMARALARA YOLLANMASI Tanımı Bu yöntemde amaç farklı numaralara farklı mesajların aynı anda yollanabilmesidir.örneğin herbir müşteriye farklı ödeme tutarlarının göndermesi gibi.bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody> <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>5</Type> <Developer>1521</Developer> <Version>xVer.2.0</Version> <Originator><![CDATA[TEST]]></Originator> <Messages> <Message> <Mesgbody><![CDATA[ ODEME TUTARINIZ 123 TLDIR.]]></Mesgbody> <Number> </Number> <SDate></SDate> <EDate></EDate> </Message> <Message> <Msgbody><![CDATA[ ODEME TUTARINIZ 225 TL DIR.]]></Msgbody> <Number> </Number> <SDate></SDate> <EDate></EDate> </Message> </Messages> </MainmsgBody> 16

18 TOPLU BINARY SMS GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya binary olarak aynı anda gönderilmesidir.bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody> <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>1</Type> <XSER>1</ XSER > <Developer>1521</Developer> <Version>xVer.2.0</Version> <Originator><![CDATA[TEST]]></Originator> <Mesgbody> binary mesaj metni 1 </Mesgbody> <Number> , </Number> <SDate></SDate> <EDate></EDate> </MainmsgBody> 18

19 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody 160 karakter olacak şekilde oluşturulan binary mesaj metni. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 19

20 BINARY SMSLERIN FARLI NUMARALARA YOLLANMASI Tanımı Bu yöntemde amaç farklı numaralara farklı mesajların binary olarak aynı anda yollanabilmesidir.örneğin herbir müşteriye farklı ödeme tutarlarının göndermesi gibi.bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version="1.0" encoding="iso "?> <MainmsgBody> <UserName>test</UserName> <PassWord> pass</password> <CompanyCode >Bayi Kodu</CompanyCode> <Type>5</Type> <Developer>1521</Developer> <Version>xVer.2.0</Version> <Originator><![CDATA[TEST]]></Originator> <XSER>1</ XSER > <Messages> <Message> <Mesgbody> <![CDATA[binary mesaj metni 1]]></Mesgbody> <Number> </Number> <SDate></SDate> <EDate></EDate> </Message> <Message> <Msgbody><![CDATA[ binary mesaj metni 2]]></Msgbody> <Number> </Number> <SDate></SDate> <EDate></EDate> </Message> </Messages> </MainmsgBody> 20

22 TOPLU LOGO GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya logo gönderimi yapmaktır. Bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version='1.0' encoding='iso '?> <MainmsgBody> <UserName> </UserName> <PassWord> </PassWord> <CompanyCode></CompanyCode> <Type>1</Type> <XSER> </XSER> <Originator><![CDATA[4751]]></Originator> <Version>Sms 5.0</Version> <Developer>Comp</Developer> <Mesgbody><![CDATA[024A]]></Mesgbody> <Numbers>90532 </Numbers> <SDate></SDate> <EDate></EDate> </MainmsgBody> 22

23 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan logonun base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 23

24 TOPLU MMS GÖNDERİMİ MMS GÖNDERİMİ İÇİN FİRMAMIZLA İRTİBATA GEÇTİKTEN SONRA EDİNECEĞİNİZ COM+ OBJELERİNİ HESAP TANIMLAMANIZ YAPILDIKTAN SONRA AŞAĞIDAKİ ADRESLER İLE BİRLİKTE KULLANABİLİRSİNİZ. Örnek Xml <MainmsgBody> <UserName>user</UserName> <PassWord>pass</PassWord> <CompanyCode>Bayi Kodu</CompanyCode> <Originator>TEST</Originator> <Version>xversion.2.0</Version> <Mesgbody>MESAJ KONUSU</Mesgbody> <Numbers> </Numbers> <Messages> <Message> <Ftype>1</Ftype> <Fdata></Fdata> <Fname></Fname> <Fkey></Fkey> <Fwidth>0</Fwidth> <Fheight>0</Fheight> </Message> </Messages> </MainmsgBody> 24

25 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan logonun base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. FType Mms gönderimine kullanılacak dosya formatını temsil eder.text dosyaları 4,resim dosyaları 1,ses dosyaları 2,video formatları 1,xml formatları 5 tipinde olmalıdır. FData Gönderilen Dosyanın Base 64 e çevrilmiş string değerini ifade eder. Fname Gönderilen Dosyanın Kişinin Telefonunda Hangi İsimle Gözükeceğini Belli Eder. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 25

26 TOPLU WAPPUSH GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya logo gönderimi yapmaktır. Bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <MainmsgBody> <UserName>user</UserName> <PassWord>pass</PassWord> <CompanyCode>Bayi Kodu</CompanyCode> <Originator>TEST</Originator> <Version>xversion.2.0</Version> <Mesgbody>MESAJ KONUSU</Mesgbody> <Numbers> </Numbers> <Messages> <Message> <Ftype></Ftype> <Fdata></Fdata> <Fname></Fname> <Fkey></Fkey> <Fwidth>0</Fwidth> <Fheight>0</Fheight> </Message> <Message> <Ftype>1</Ftype> <Fdata></Fdata> <Fname></Fname> <Fkey></Fkey> <Fwidth>0</Fwidth> <Fheight>0</Fheight> </Message> </Messages> </MainmsgBody> 26

27 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan logonun base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. Ftype Gönderilen Dosyanın Tipini Belli Eder.Resim dosyaları(ico,png,jpeg,gif,tiff) 1,Ses Dosyaları (wav) 2,Video Dosyaları(3gp,mpeg,avi,wav,mp4) 3,Metin Dosyaları 4(txt) ifade eder. FData Gönderilen Dosyanın Base 64 e çevrilmiş string değerini ifade eder. Fname Gönderilen Dosyanın Kişinin Telefonunda Hangi İsimle Gözükeceğini Belli Eder. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 27

28 TOPLU SESLI MESAJ GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya sesli mesaj gönderimi yapmaktır. Bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <MainmsgBody> <UserName>user</UserName> <PassWord>pass</PassWord> <CompanyCode>Bayi Kodu</CompanyCode> <Originator>TEST</Originator> <Version>xversion.2.0</Version> <Mesgbody><![CDATA[sesMemo]]></Mesgbody> <Numbers> </Numbers> <Credit>10</Credit> <Messages> <Message> <Ftype>2</Ftype> <Fname></Fname> <Fdata></Fdata> <Fkey>21</Fkey> </Message> </Messages> </MainmsgBody> 28

29 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan logonun base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. Ftype Gönderilen Dosyanın Tipini Belli Eder. Ses Dosyaları (wav) 2. FData Gönderilen Dosyanın Base 64 e çevrilmiş string değerini ifade eder. Fname Gönderilen Dosyanın Kişinin Telefonunda Hangi İsimle Gözükeceğini Belli Eder. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 29

30 TOPLU BROSUR GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya brosur gönderimi yapmaktır. Bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <MainmsgBody> <UserName>user</UserName> <PassWord>pass</PassWord> <CompanyCode>Bayi Kodu</CompanyCode> <Originator>TEST</Originator> <Version>xversion.2.0</Version> <Mesgbody><![CDATA[sesMemo]]></Mesgbody> <Numbers> </Numbers> <Credit>10</Credit> <Messages> <Message> <Ftype></Ftype> <Fname></Fname> <Fdata></Fdata> <Fkey></Fkey> <Fwidth>0</Fwidth> <Fheight>0</Fheight> </Message> </Messages> </MainmsgBody> 30

31 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan logonun base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. Ftype Gönderilen Dosyanın Tipini Belli Eder(Resim Dosyaları 1(ico,png,jpeg,gif,tiff),Video Dosyaları 3(3gp,mpeg,avi,wav,mp4,flv),Pdf Dosyaları 7,Power Point Dosyaları 7(ppt,pptx),Flash Dosyaları 9(swf),) FData Gönderilen Dosyanın Base 64 e çevrilmiş string değerini ifade eder. Fname Gönderilen Dosyanın Kişinin Telefonunda Hangi İsimle Gözükeceğini Belli Eder. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 31

32 TOPLU VİDEO GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya video gönderimi yapmaktır. Bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <MainmsgBody> <UserName>user</UserName> <PassWord>pass</PassWord> <CompanyCode>Bayi Kodu</CompanyCode> <Originator>TEST</Originator> <Version>xversion.2.0</Version> <Mesgbody><![CDATA[sesMemo]]></Mesgbody> <Numbers> </Numbers> <Credit>10</Credit> <Messages> <Message> <Ftype></Ftype> <Fname></Fname> <Fdata></Fdata> <Fkey></Fkey> <Fwidth>0</Fwidth> <Fheight>0</Fheight> </Message> </Messages> </MainmsgBody> 32

33 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan logonun base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. Ftype Gönderilen Dosyanın Tipini Belli Eder(Video Dosyaları 3(3gp,mpeg,avi,wav,mp4)) FData Gönderilen Dosyanın Base 64 e çevrilmiş string değerini ifade eder. Fname Gönderilen Dosyanın Kişinin Telefonunda Hangi İsimle Gözükeceğini Belli Eder. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 33

34 TOPLU MELODi GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya melodi gönderimi yapmaktır. Bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version='1.0' encoding='iso '?> <MainmsgBody> <UserName> </UserName> <PassWord> </PassWord> <CompanyCode></CompanyCode> <Type>1</Type> <XSER> </XSER> <Originator><![CDATA[4751]]></Originator> <Version>Sms 5.0</Version> <Developer>Comp</Developer> <Mesgbody><![CDATA[024A]]></Mesgbody> <Numbers>90532 </Numbers> <SDate></SDate> <EDate></EDate> </MainmsgBody> 34

35 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan melodinin base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 35

36 TOPLU VCARD GONDERIMI Tanımı Bu yöntemde amaç aynı mesajın birden çok numaraya vcard gönderimi yapmaktır. Bu yöntemde kullanılacak XML Envelope ve url adresi aşağıdaki gibidir. Örnek Xml <?xml version='1.0' encoding='iso '?> <MainmsgBody> <UserName> </UserName> <PassWord> </PassWord> <CompanyCode></CompanyCode> <Type>1</Type> <XSER> F40000</XSER> <Originator><![CDATA[4751]]></Originator> <Version>Sms 5.0</Version> <Developer>Comp</Developer> <Mesgbody><![CDATA[024A]]></Mesgbody> <Numbers>90532 </Numbers> <SDate></SDate> <EDate></EDate> </MainmsgBody> 36

37 Xml Envelop Açıklamaları Username Bayiniz tarafından sağlanacak kullanıcı adı Password Kullanıcı şifreniz CompanyCode Bayiniz Tarafından Verilen Kod Mesgbody Gönderilecek olan vcard ın base64 string olarak yazılması. Developer Version Yazılım firması tarafından en çok 15 karakter verilebilen özel kod. Originator Gönderici başlığı en az 3 en fazla 11 karakter kullanılabilir.türkçe karakter kullanılamaz. Numbers Mesaj gönderilecek numaralar her bir numara ülke kodunu da içeren uluslararası formatta olmalı ve numaralar arasında ayıraç olarak virgule(,) kullanılmalı,ülke ve operator kodları yukarıdaki örnekte olduğu gibi karakteri ile birbirinden ayrılmalıdır.ülke kodunun verilmemesi durumunda ( gibi) ülke kodu varsayılan olarak 90 kabul edilecektir. SDate Mesajın gönderilmeye başlanacağı tarihi gösterir.formatı ddmmyyyyhhmm dir.bu değer girilmediği durumda an itibariyle gönderim başlayacaktır. EDate Mesajın gönderilme işleminin sonlandırılacağı zamandır.bu tarihten sonar mesaj gönderme durdurulacak ve beklemeye alınan mesajlar zaman aşımı(timeout) olacaktır. Response Cevap Açıklamaları İşleminin başarılı olması durumunda sizlere ID: gibi bir sonuç dönecektir.eğer bu şekilde bir dönüş yapılmazsa hata kodlarına bakmanızı çözüm üretilemezse yetkili bayiniz ile görüşmenizi tavsiye ederiz. 37

38 DETAY RAPOR ALIMI Tanımı Her bir paketin detay raporunu almak için aşağıda verilen XML Envelop un Aşağıdaki adrese Post Edilmesi gerekmektedir. Örnek Xml <?xml version='1.0' encoding='iso '?> <ReportMain> <UserName> UserName </UserName> <PassWord> PassWord </PassWord> <CompanyCode >Bayi Kodu</CompanyCode> <Msgid> Msgid </Msgid> <Type> Type</Type> <Delm> </Delm> </ReportMain> 38

39 Xml Envelop Açıklamaları Username Kullanıcı Adı PassWord Kullanıcı Şifresi Msgid Paketin işleme alındığı tarih/saat RType İstenilen Rapor Tipi(1 İletildi,2 Beklemede,3 Hatalı,4 Zaman Aşımı) Type alanı girilmediği durumlarda toplam rapor görüntülenir.(iletilen,beklemede,hatalı ve zaman aşımları Birlikte Görüntülenir.) Delimiter Type alanı boş girildiği durumlarda dikkate alınır.default değeri ; dir. Numara Durum Kodları 1 Bekleyen Numaralar(Kullanımda ancak kapsama alanı dışında yada telefon kapalı) 2 İletilen Numaralar 3 Sistem Hatası(bu numara kullanımda değil yada servis dışı) 4 İletilememesinden dolayı zaman aşımı (Xml içinde SDATE ve EDATE değerleri verilmediği takdirde default 24 saattir.) Rapor Alımında Alınabilecek Hata Kodları 00 Hatalı Kullanıcı Adı yada şifresi 01 Hatalı Kullanıcı Adı yada şifresi 20 Özet Raporda;verilen dönem için atış bulunamadı. 21 Detay Raporda;verilen parametreler için rapor bulunamadı yada rapor henüz hazır değil. Örnek Rapor

40 ORIGINATOR SORGULAMA Tanımı Kullanıcı kullanabileceği Originator ları sorgulamak istediği durumlarda kullanılır.bunun için aşağıda verilen Xml Envelop un aşağıdaki adrese Post Edilmesi gerekmektedir. Örnek Xml <?xml version='1.0' encoding='iso '?> <OriginMain> <UserName>Company Username</UserName> <PassWord>Company Password</PassWord> <CompanyCode >Bayi Kodu</CompanyCode> <User>User</User> <Originator>DENEME</Originator> </OriginMain> Örnek Response OK(İlk satırda Başarılı Durum Kontrolü) ORIGINATOR 1 ORIGINATOR 2. Originator Sorgulamada Alınabilecek Hata Kodları 01 Hatalı Kullanıcı Adı yada şifresi 100 XML Hatası 40

41 KREDİ SORGULAMA Tanımı Kullanıcı mevcut kredisini sorgulamak istediği durumlarda kullanılır.bunun için aşağıda verilen Xml Envelop un aşağıdaki adrese Post Edilmesi gerekmektedir. Örnek Xml <?xml version='1.0' encoding='iso '?> < Main> <UserName>Company Username</UserName> <PassWord>Company Password</PassWord> <CompanyCode >Bayi Kodu</CompanyCode> </Main> Örnek Response Satır:Kredi Miktarı 2.Satır:Expire Değeri. Yyyymmdd formatında Originator Sorgulamada Alınabilecek Hata Kodları 00 Kullanıcı Bilgileri Boş 01 Hatalı Kullanıcı Adı yada şifresi 02 Hesap Kapalı 03 Kontör Hatası 06 Bu işlem için Yetkiniz Yok 10 Geçersiz IP Adresi 100 XML Hatası 41

42 İLETİŞİM BİLGİLERİ: Telefon: Faks: Web site: [email protected] 42

Daha göster