MARKAM SMS SMS GÖNDERİM WEB SERVİSLERİ VERSİYON 1.2 KASIM 2014
1. WEB SERVİS ADRESİ 2. WEB SERVİS METODLARI a. Mesaj Başlığı Listesi Servisi b. Rehberdeki Gruplar c. Rehberdeki Kayıtlar d. Anlık Sms Gönderim Servisi e. Anlık Sms Gönderim Servisi - Son Gönderim Zamanı Kısıtlı f. İleri Tarihli Sms Gönderim Servisi 3. WEB SERVİS SONUÇ KODLARI 4. WSDL - 1 -
1. WEB SERVİS WSDL ADRESİ http://service.markamsms.com/service/desmsservice.asmx?wsdl 2. WEB SERVİS METODLARI a. GetOriginatorList Kullanıcının mesaj başlıklarını verir. Parametre Zorunlu Veri Tipi Format Açıklama Username Evet String MARKAMSMS sitesindeki kullanıcı adı Password Evet String MARKAMSMS sitesindeki şifre - 2 -
b. GetAddressBookGroupList Kullanıcının adres defterinde kayıtlı grupların listesini verir. Parametre Zorunlu Veri Tipi Format Açıklama Username Evet String MARKAMSMS sitesindeki kullanıcı adı Password Evet String MARKAMSMS sitesindeki şifre - 3 -
c. GetAddressBookList Kullanıcının adres defterinde kayıtlı kişilerin listesini verir. Parametre Zorunlu Veri Tipi Format Açıklama Username Evet String MARKAMSMS sitesindeki kullanıcı adı Password Evet String MARKAMSMS sitesindeki şifre address_book_groupid Evet İnt Adres defteri grup ID si Tüm kişileri almak için 0 verilmeli. Grupsuzları almak için -1 verilmeli. Belirli bir gruptaki kişilerin listesini almak için o grubun ID si verilmeli. - 4 -
d. SendInstantSMS SMS gönderimi hemen başlar. Parametre Zorunlu Veri Tipi Format Açıklama Username Evet String MARKAMSMS sitesindeki kullanıcı adı Password Evet String MARKAMSMS sitesindeki şifre Originator Evet String Mesaj başlığı Message Evet String SMS metni Receipients Evet String 905xxxxxxxxx,905xxxxxxxxx Mesajın gönderileceği telefon numaraları, virgülle ayrılmış şekilde ve her bir numara 905xxxxxxxxx formatında. Division_time Evet İnt Bölerek gönderilmek isteniyorsa her bir gönderim arasındaki süre. (Dakika Cinsinden) Bölerek gönderilmeyecekse değer olarak 0 (Sıfır) girilir. Division_Receiver_Count Evet İnt Bölerek gönderimlerde her bir pakette gönderilecek adet Bölerek gönderilmeyecekse değer olarak 0 (Sıfır) girilir. - 5 -
e. SendInstantSMSSendEndTimeLimited SMS gönderimi hemen başlar. Belli bir zamanda sonlanır. Parametre Zorunlu Veri Format Açıklama Tipi Username Evet string MARKAMSMS sitesindeki kullanıcı adı Password Evet string MARKAMSMS sitesindeki şifre Originator Evet string Mesaj başlığı Message Evet string SMS metni Receipients Evet string 905xxxxxxxxx,905xxxxxxxxx Mesajın gönderileceği telefon numaraları, virgülle ayrılmış şekilde ve her bir numara 905xxxxxxxxx formatında. Send_End_Time Evet string dd.mm.yyyy hh:mm Mesajın en son gönderileceği tarih saat. Division_Time Evet int Bölerek gönderilmek isteniyorsa her bir gönderim arasındaki süre. (Dakika Cinsinden) Bölerek gönderilmeyecekse değer olarak 0 (Sıfır) girilir. Division_Receiver_Count Evet int Bölerek gönderimlerde her bir pakette gönderilecek adet Bölerek gönderilmeyecekse değer olarak 0 (Sıfır) girilir. - 6 -
3. WEB SERVİS SONUÇ KODLARI: Result Code = 00 Result Code = 01 Result Code = 02 Result Description = İşlem başarılı Result Description = Hatalı kullanıcı adı / şifre Result Description = Sms gönderiminde hata oluştu - 7 -
4. WSDL: <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions xmlns:s="http://www.w3.org/2001/xmlschema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://service.markamsms.com/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tm="http://microsoft.com/wsdl/mime/textmatching/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" targetnamespace="http://service.markamsms.com/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> <wsdl:types> <s:schema elementformdefault="qualified" targetnamespace="http://service.markamsms.com/"> <s:element name="getoriginatorlist"> <s:element minoccurs="0" maxoccurs="1" name="username" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="password" type="s:string" /> <s:element name="getoriginatorlistresponse"> <s:element minoccurs="1" maxoccurs="1" name="getoriginatorlistresult" type="tns:originatorresult" /> <s:complextype name="originatorresult"> <s:element minoccurs="0" maxoccurs="1" name="originator_list" type="tns:arrayofstring" /> <s:element minoccurs="0" maxoccurs="1" name="result_code" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="result_description" type="s:string" /> <s:complextype name="arrayofstring"> <s:element minoccurs="0" maxoccurs="unbounded" name="string" nillable="true" type="s:string" /> <s:element name="sendinstantsms"> <s:element minoccurs="0" maxoccurs="1" name="username" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="password" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="originator" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="message" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="receipients" type="s:string" /> <s:element minoccurs="1" maxoccurs="1" name="division_time" type="s:int" /> <s:element minoccurs="1" maxoccurs="1" name="division_receiver_count" type="s:int" /> <s:element name="sendinstantsmsresponse"> <s:element minoccurs="1" maxoccurs="1" name="sendinstantsmsresult" type="tns:smsresult" /> <s:complextype name="smsresult"> <s:element minoccurs="0" maxoccurs="1" name="smsid" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="result_code" type="s:string" /> - 8 -
<s:element minoccurs="0" maxoccurs="1" name="result_description" type="s:string" /> <s:element name="sendinstantsmssendendtimelimited"> <s:element minoccurs="0" maxoccurs="1" name="username" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="password" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="originator" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="message" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="receipients" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="send_end_time" type="s:string" /> <s:element minoccurs="1" maxoccurs="1" name="division_time" type="s:int" /> <s:element minoccurs="1" maxoccurs="1" name="division_receiver_count" type="s:int" /> <s:element name="sendinstantsmssendendtimelimitedresponse"> <s:element minoccurs="1" maxoccurs="1" name="sendinstantsmssendendtimelimitedresult" type="tns:smsresult" /> <s:element name="sendfuturesms"> <s:element minoccurs="0" maxoccurs="1" name="username" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="password" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="originator" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="message" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="receipients" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="send_start_time" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="send_end_time" type="s:string" /> <s:element minoccurs="1" maxoccurs="1" name="division_time" type="s:int" /> <s:element minoccurs="1" maxoccurs="1" name="division_receiver_count" type="s:int" /> <s:element name="sendfuturesmsresponse"> <s:element minoccurs="1" maxoccurs="1" name="sendfuturesmsresult" type="tns:smsresult" /> <s:element name="getaddressbookgrouplist"> <s:element minoccurs="0" maxoccurs="1" name="username" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="password" type="s:string" /> <s:element name="getaddressbookgrouplistresponse"> <s:element minoccurs="1" maxoccurs="1" name="getaddressbookgrouplistresult" type="tns:addressbookgroupresult" /> - 9 -
<s:complextype name="addressbookgroupresult"> <s:element minoccurs="0" maxoccurs="1" name="address_book_group_list" type="tns:arrayofaddressbookgroup" /> <s:element minoccurs="0" maxoccurs="1" name="result_code" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="result_description" type="s:string" /> <s:complextype name="arrayofaddressbookgroup"> <s:element minoccurs="0" maxoccurs="unbounded" name="addressbookgroup" type="tns:addressbookgroup" /> <s:complextype name="addressbookgroup"> <s:element minoccurs="1" maxoccurs="1" name="id" type="s:int" /> <s:element minoccurs="0" maxoccurs="1" name="name" type="s:string" /> <s:element name="getaddressbooklist"> <s:element minoccurs="0" maxoccurs="1" name="username" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="password" type="s:string" /> <s:element minoccurs="1" maxoccurs="1" name="address_book_groupid" type="s:int" /> <s:element name="getaddressbooklistresponse"> <s:element minoccurs="1" maxoccurs="1" name="getaddressbooklistresult" type="tns:addressbooklistresult" /> <s:complextype name="addressbooklistresult"> <s:element minoccurs="0" maxoccurs="1" name="address_book_list" type="tns:arrayofaddressbooklist" /> <s:element minoccurs="0" maxoccurs="1" name="result_code" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="result_description" type="s:string" /> <s:complextype name="arrayofaddressbooklist"> <s:element minoccurs="0" maxoccurs="unbounded" name="addressbooklist" type="tns:addressbooklist" /> <s:complextype name="addressbooklist"> <s:element minoccurs="1" maxoccurs="1" name="id" type="s:int" /> <s:element minoccurs="0" maxoccurs="1" name="name" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="surname" type="s:string" /> <s:element minoccurs="0" maxoccurs="1" name="gsm_number" type="s:string" /> </s:schema> </wsdl:types> <wsdl:message name="getoriginatorlistsoapin"> <wsdl:part name="parameters" element="tns:getoriginatorlist" /> <wsdl:message name="getoriginatorlistsoapout"> <wsdl:part name="parameters" element="tns:getoriginatorlistresponse" /> - 10 -
<wsdl:message name="sendinstantsmssoapin"> <wsdl:part name="parameters" element="tns:sendinstantsms" /> <wsdl:message name="sendinstantsmssoapout"> <wsdl:part name="parameters" element="tns:sendinstantsmsresponse" /> <wsdl:message name="sendinstantsmssendendtimelimitedsoapin"> <wsdl:part name="parameters" element="tns:sendinstantsmssendendtimelimited" /> <wsdl:message name="sendinstantsmssendendtimelimitedsoapout"> <wsdl:part name="parameters" element="tns:sendinstantsmssendendtimelimitedresponse" /> <wsdl:message name="sendfuturesmssoapin"> <wsdl:part name="parameters" element="tns:sendfuturesms" /> <wsdl:message name="sendfuturesmssoapout"> <wsdl:part name="parameters" element="tns:sendfuturesmsresponse" /> <wsdl:message name="getaddressbookgrouplistsoapin"> <wsdl:part name="parameters" element="tns:getaddressbookgrouplist" /> <wsdl:message name="getaddressbookgrouplistsoapout"> <wsdl:part name="parameters" element="tns:getaddressbookgrouplistresponse" /> <wsdl:message name="getaddressbooklistsoapin"> <wsdl:part name="parameters" element="tns:getaddressbooklist" /> <wsdl:message name="getaddressbooklistsoapout"> <wsdl:part name="parameters" element="tns:getaddressbooklistresponse" /> <wsdl:porttype name="desmsservicesoap"> <wsdl:operation name="getoriginatorlist"> <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">mesaj Başlıkları</wsdl:documentation> <wsdl:input message="tns:getoriginatorlistsoapin" /> <wsdl:output message="tns:getoriginatorlistsoapout" /> <wsdl:operation name="sendinstantsms"> <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">sms Gönderim Servisi - Gönderim Aynı Anda Başlar</wsdl:documentation> <wsdl:input message="tns:sendinstantsmssoapin" /> <wsdl:output message="tns:sendinstantsmssoapout" /> <wsdl:operation name="sendinstantsmssendendtimelimited"> <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">sms Gönderim Servisi - Gönderim Aynı Anda Başlar, Son Gönderim Zamanı Kısıtlı</wsdl:documentation> <wsdl:input message="tns:sendinstantsmssendendtimelimitedsoapin" /> <wsdl:output message="tns:sendinstantsmssendendtimelimitedsoapout" /> <wsdl:operation name="sendfuturesms"> <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">ileri Tarihli SMS Gönderim Servisi</wsdl:documentation> <wsdl:input message="tns:sendfuturesmssoapin" /> <wsdl:output message="tns:sendfuturesmssoapout" /> <wsdl:operation name="getaddressbookgrouplist"> <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">rehberdeki Gruplar</wsdl:documentation> <wsdl:input message="tns:getaddressbookgrouplistsoapin" /> <wsdl:output message="tns:getaddressbookgrouplistsoapout" /> <wsdl:operation name="getaddressbooklist"> <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">rehberdeki Kayıtlar</wsdl:documentation> <wsdl:input message="tns:getaddressbooklistsoapin" /> <wsdl:output message="tns:getaddressbooklistsoapout" /> - 11 -
</wsdl:porttype> <wsdl:binding name="desmsservicesoap" type="tns:desmsservicesoap"> <soap:binding transport="http://schemas.xmlsoap.org/soap/http" /> <wsdl:operation name="getoriginatorlist"> <soap:operation soapaction="http://service.markamsms.com/getoriginatorlist" style="document" /> <wsdl:operation name="sendinstantsms"> <soap:operation soapaction="http://service.markamsms.com/sendinstantsms" style="document" /> <wsdl:operation name="sendinstantsmssendendtimelimited"> <soap:operation soapaction="http://service.markamsms.com/sendinstantsmssendendtimelimited" style="document" /> <wsdl:operation name="sendfuturesms"> <soap:operation soapaction="http://service.markamsms.com/sendfuturesms" style="document" /> <wsdl:operation name="getaddressbookgrouplist"> <soap:operation soapaction="http://service.markamsms.com/getaddressbookgrouplist" style="document" /> <wsdl:operation name="getaddressbooklist"> <soap:operation soapaction="http://service.markamsms.com/getaddressbooklist" style="document" /> </wsdl:binding> <wsdl:binding name="desmsservicesoap12" type="tns:desmsservicesoap"> <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" /> <wsdl:operation name="getoriginatorlist"> - 12 -
<soap12:operation soapaction="http://service.markamsms.com/getoriginatorlist" style="document" /> <wsdl:operation name="sendinstantsms"> <soap12:operation soapaction="http://service.markamsms.com/sendinstantsms" style="document" /> <wsdl:operation name="sendinstantsmssendendtimelimited"> <soap12:operation soapaction="http://service.markamsms.com/sendinstantsmssendendtimelimited" style="document" /> <wsdl:operation name="sendfuturesms"> <soap12:operation soapaction="http://service.markamsms.com/sendfuturesms" style="document" /> <wsdl:operation name="getaddressbookgrouplist"> <soap12:operation soapaction="http://service.markamsms.com/getaddressbookgrouplist" style="document" /> <wsdl:operation name="getaddressbooklist"> <soap12:operation soapaction="http://service.markamsms.com/getaddressbooklist" style="document" /> </wsdl:binding> <wsdl:service name="desmsservice"> <wsdl:port name="desmsservicesoap" binding="tns:desmsservicesoap"> <soap:address location="http://desms-admin.yazilimfabrikasi.com.tr/service/desmsservice.asmx" /> </wsdl:port> <wsdl:port name="desmsservicesoap12" binding="tns:desmsservicesoap12"> <soap12:address location="http://desms-admin.yazilimfabrikasi.com.tr/service/desmsservice.asmx" /> </wsdl:port> </wsdl:service> - 13 -
</wsdl:definitions> - 14 -