تحلیل سیستم کسب و کار اینترنتی

شرح متدهاي وب سرويس :

 متد GetSystemCredit : به دست آوردن مانده اعتبار پرتال به ريال

پارامترهاي ورودي :

PortalCode : کد پرتال يا کد اشتراک کاربر

UserName : نام کاربري مدير سيستم

PassWord : کلمه عبور مدير سيستم

خروجي متد : ميزان اعتبار پرتال به ريال

متد SingleSMSEngine : ارسال پيام تکي Single

پارامترهاي ورودي :

PortalCode : کد پرتال يا کد اشتراک کاربر

UserName : نام کاربري مدير سيستم

PassWord : کلمه عبور مدير سيستم

Mobile : شماره موبايل گيرنده (09XXXXXXXXX)

Message : متن پيامک

FlashSMS : آيا ارسال به ‌صورت فلش صورت پذيرد يا خير (از نوع Boolean)

ServerType : مشخص کننده مرجع ارسال پيامک طبق جدول شماره يک

پارامتر خروجي : کد رهگيري مخابراتي پيامک ارسال شده و يا کد خطا طبق جدول شماره دو

متد MultiSMSEngine : ارسال پيامک انبوه به صورت نظير به نظير

پارامترهاي ورودي :

PortalCode : کد پرتال يا کد اشتراک کاربر

UserName : نام کاربري مدير سيستم

PassWord : کلمه عبور مدير سيستم

Mobiles() : آرايه‌اي از شماره موبايل‌هاي گيرنده

Messages() : آرايه‌اي از متن پيامک‌هاي گيرنده متناظر با انديس‌هاي آرايه Mobiles

FlashSMS : آيا ارسال به شکل فلش صورت پذيرد يا خير (از نوع Boolean)

ServerType : مشخص کننده مرجع ارسال پيامک طبق جدول شماره يک

پارامتر خروجي : آرايه‌اي از کدهاي رهگيري مخابراتي پيامک‌هاي ارسال شده و يا کدهاي خطا طبق جدول شماره دو

نمونه کدهای C# :

-         دریافت میزان اعتبار مخابراتی  :

 messagingws.SendSMS WS = new messagingws.SendSMS();   Response.Write(WS.GetSystemCredit(Portal Code, "username", "password"));

-         ارسال تکی:

 messagingws.SendSMS WS = new messagingws.SendSMS();         Response.Write(WS.SingleSMSEngine(portal code,"username","password","شماره موبایل","متن ارسال",false,1));

-         ارسال انبوه برای 4 شماره موبایل:

        messagingws.SendSMS WS = new messagingws.SendSMS();

        String [] Mobiles = new string [5];

        String [] Messages = new string [5];

        Mobiles [0] = "09121111111";

        Mobiles [1] = "09122222222";

        Mobiles [2] = "09123333333";

        Mobiles [3] = "09124444444";

        Mobiles[4] = "09121111111";

        Messages[0] = "تست انبوه وب سرویس 1";

        Messages[1] = " تست انبوه وب سرویس 2";

        Messages[2] = " تست انبوه وب سرویس 3";

        Messages[3] = " تست انبوه وب سرویس 4";

        Messages[4] = " تست انبوه وب سرویس 1";

       Response.Write(WS.MultiSMSEngine (portal code, "username", "password",         Mobiles, Messages, false, 1));

ﻧﮑﺘﻪﻣﻬﻢ: همانطورﮐﻪ در کدهای C#ﻣﯽﺗﻮان ﻣﺸﺎهدﻩ ﻧﻤﻮد، اﻧﺪﻳﺲ 0 ﺧﻮاﻧﺪﻩ ﻧﻤﯽﺷﻮد، ﭘﺲ ﺑﺎﻳﺪ ﻳﮑﯽ از ﻣﻘﺪار واﻗﻌﯽ ﺑﻴﺸﺘﺮ در ﻧﻈﺮ ﮔﺮﻓﺘﻪ و ﻣﻘﺪاردهی ﮐﺮد. ﺑﺪﻳﻦ ﻃﺮﻳﻖ درC#اﻧﺪﻳﺲ اول وﺁﺧﺮ ﻋﻴﻨﺎ ﻣﺜﻞ هم ﻣﯽﺑﺎﺷﻨﺪ و ﺑﺪﻳﻦﻦ ﻃﺮﻳﻖ ارﺳﺎل ﮐﺎﻣﻞ اﻧﺠﺎم ﺧﻮاهد ﺷﺪ.

نمونه کدهای PHP :

//Function Call

sendSMSFun($_REQUEST['mobile'],$_REQUEST['text'],$_REQUEST['code'],$_REQUEST['user'],$_REQUEST['pass'],$_REQUEST['encode'],$_REQUEST['flash'],$_REQUEST['type']);

//Single SMS Function

function sendSMSFun($mobile,$text,$code,$username,$password,$encode,$flash,$type){

$curlData = '

'.$code.''.$username.''.$password.''.$mobile.''.$text.''.$encode.''.$flash.''.$type.'';

$url='http://MessagingWS. XXXXXXXX/SendSMS.asmx?WSDL';$curl = curl_init();curl_setopt ($curl, CURLOPT_URL, $url);curl_setopt($curl,CURLOPT_HTTPHEADER,array ('SOAPAction:"MessagingWS/SingleSMSEngine"','Content-Type: text/xml; charset=utf-8'));curl_setopt ($curl, CURLOPT_POST, 1);curl_setopt ($curl, CURLOPT_POSTFIELDS, $curlData);$result = curl_exec($curl);curl_close ($curl);

}

?>

همانطور که در نمونه کدهای بالا مشاهده مینمایید، دو تابع single sms function و function call آورده شده است که تابع function call را در هر جایی از برنامه قرار دهید، ارسال تکی را انجام خواهد شد. شما احتیاجی به تغییر کدهای این تابع ندارید و تنها کافی است تا اطلاعات مورد نظر شامل:موبایل، متن، کداشتراک، نام کاربری، پسورد، encode، فلش و مرجع ارسال را در single sms function معین نمایید. میتوانید این پارامترها را از طریق post یا get دریافت کنید و یا به صورت مستقیم در همین نمونه کد به صورت زیر قرار دهید :

sendSMSFun('09121111111','salam php','147','testuser','testpass','2','0','1')

1. ارسال از طريق URL

بدين منظور، پيامک‌هاي خود را به صورت تکي به آدرس ذيل ارسال(Post) نمائيد :

http://www.XXXXXXXX/URLSend.aspx?Username=&Password=&PortalCode=&Mobile=&Message=&Flash=

به جاي XXXXXXXX نام دامنه شرکت فراهم‌آورنده دسترسي خود را قرار دهيد (مثلا : XSMS.com)

پارامترهايي که بايد تنظيم شوند عبارتند از :

: شماره موبايل گيرنده پيامMobile

: متن پيام به فارسي يا انگليسيMessage

: نام کاربري مدير سيستمUsername

: کلمه عبور مدير سيستمPassword

: کد اشتراکPortalCode

Flash : ارسال به صورت فلش انجام شود(عدد 1) يا عادي(عدد 0)

سيستم در ازاي اين درخواست کد پيامک ارسال شده و يا کدخطا را مطابق با جدول شماره دو بازخواهد گرداند

1. دريافت پيامک :

به منظور دريافت پيامک URL اختصاصي خود را به فرمت زير در قسمت مربوطه در زيرمنوي  "تنظيمات برنامه‌نويسان" از منوي اصلي "تنظيمات" وارد نمائيد :

Http://www.MyDomain/ReceiveSMS.aspx

سرور در زمان دريافت پياک‌هاي مرتبط با پرتال شما، مشخصات فرستنده و متن پيامک را در قالب پارامترهاي زير به آدرس مشخص شده Post مي‌نمايد و ميتوان از طريق Query String به محتواي آن دست يافت.

Http://www.MyDomain/ReceiveSMS.aspx?From=$From&Message=$Message

پارامتر From : شماره موبايل فرستنده پيامک

پارامتر Message : متن ارسال شده

جدول شماره يک : کدهاي مرجع ارسال پيامک

جدول شماره دو : کدهاي خطاي بازگشتي وب سرويس