مستندات وب سرویس ارسال پیامک

وب سرویس ارسال پیامک برای  ﺁﻥ ﺩﺳﺘﻪ ﺍﺯ ﺑﺮﻧﺎﻣﻪ ﻧﻮﻳﺴﺎﻧﻲ ﻃﺮﺍﺣﻲ ﺷﺪﻩ ﺍﺳﺖ ﻛﻪ ﻣﻲ‌ﺧﻮﺍﻫﻨﺪ ﺑﺎ ﺍﺳﺘﻔﺎﺩﻩ ﺍﺯ ﻧﺮﻡ افزار ﺁﻣﺎﺩﻩ ﺧﻮﺩ ﺑﺮ ﺭﻭﻱ ﺑﺴﺘﺮ ﺳﻴﺴﺘﻤ‌ﻬﺎﻱ ﭘﻴﺎﻡ‌ﺩﻫﻲ سهند سامانه، ﺑﻪ ﺍﺭﺳﺎﻝ ﻭ ﺩﺭﻳﺎﻓﺖ ﭘﻴﺎﻣﻚ ﺑﭙﺮﺩﺍﺯﻧﺪ. این سرویس امکان ارسال پیامک  با استفاده از وب سرویس های شرکت سهند سامانه را دراختیار کاربران قرار میدهد.

متد SendQueue: این متد وب سرویس جهت ارسال یک پیامک به یک یا چندین دریافت کننده به کار می‌رود. این متد به صورت غیر مستقیم  و توسط سرور شرکت عمل می نماید.

نام پارامتر	نوع پارامتر	توضیح
UserName	String	نام کاربری حساب در سیستم سهند سامانه
Password	String	رمز عبور حساب در سیستم سهند سامانه
Message	String	رشته ای که متن پیامک در آن قرار میگیرد
FromNumber	String	خط ارسال کننده پیامک
toNumber	Array Of String	شماره گیرندگان در این پارامتر قرار میگیرد
پارامتر خروجی
Array Of String		کد پیامک ارسال شده ویا کد خطا

متد ArraySendQeue: از این متد  وب سرویس برای ارسال پیامک به‌صورت چند به چند استفاده می‌شود (ارسال از چند خط به چندین گیرنده متفاوت). خروجی این متد از نوع آرایه از رشته است که شامل کد پیامک ارسال شده ویا شماره خطا می‌باشد.

متد GetQueueMessageStatus این متد جهت اطلاع از وضعیت پیامک های ارسالی به صورت غیر مستقیم  و توسط متد SendQueue و ArraySendQeue از طریق سرور شرکت ارسال شده است.

نام پارامتر	نوع پارامتر	توضیح
UserName	String	نام کاربری حساب در سیستم سهند سامانه
Password	String	رمز عبور حساب در سیستم سهند سامانه
MessageIds	Array Of Long Integer	شناسه پیام که در اصل مقدار بازگشتی متد Send برای پیام‌های مورد نظر می‌باشد
پارامتر خروجی
Integer Array Of		وضعیت پیام ها تا این لحظه ویا کد خطا

متد GetUserCredit: این متد وب سرویس برای گرفتن اعتبار باقیمانده توسط کاربر است مقدار برگشتی آن از نوع عدد صحیح می باشد.

متد RecieveSMS: این متد وب سرویس برای دریافت پیامک های است که از طرف مخاطبین به شماره خط ارسال می گردد. در واقع پس از ارسال پیامک توسط مخاطبین پیامک توسط سرویس های این شرکت دریافت گردید و شما با استفاده از این متد
می توانید پیامک های خود را استخراج نمائید. در واقع برای هر بار استفاده از این متد می بایست بازه زمانی مورد نظر خود را که قصد دریافت پیامک های آن را دارید در پارامترهای ورودی این متد منظور نمائید. مقدار برگشتی این متد یک DataTable حاوی اطلاعات مربوط به پیامک دریافتی می باشد.

متد GetUnreadMessagese  :

این متد جهت اطلاع از لیست پیامکهای تاکنون از وب سرویس دریافت نشده است.

متد SendFormUrl  : این متد وب سرویس  جهت ارسال پیامک  توسط url به کار می رود. نکته اینکه، لیست شماره موبایل های دریافت کننده پیامک می بایست توسط “,” جدا شده باشند و به پارامتر toNumber پاس داده شوند. این متد به صورت غیر مستقیم  و توسط سرور شرکت عمل می نماید. دقت کنید آرایه ای که بعنوان خروجی ارسال میگرد باید تعداد خانهای آرایه برابر با تعداد شماره باشد و عدد نباشد در غیر اینصورت ارسال با خطا صورت گرفته است.

مثال : در این مثال  از جاوا اسکریپت استفاده شده است :

<script type=”text/javascript”>

function send_with_ajax(the_url) {

var UserName = ‘username’;

        var Password = ‘password’;

        var Message = ‘TestMessage’;

        var FromNum = ‘3000xxxxxxxx’;

        var ToNums = ‘0919xxxxxxx’;

        var url = ” http://webservice.sahandsms.com/NewSmsWebservice.asmx/SendFromUrl?username=” + UserName + “&password=” + Password + “&message=” + encodeURIComponent(Message) + “&fromNumber=” + FromNum + “&toNumber=” + ToNums;

        var httpRequest = new XMLHttpRequest();

        var SendCount = 1;

        httpRequest.onreadystatechange = function () { if (httpRequest.readyState == 4) { if (httpRequest.responseXML.text.split(” “).length == SendCount) alert(‘ارسال با موفقیت انجام شد’); } };

        httpRequest.open(“GET”, url, true);

        httpRequest.send(null);

    }

        }

</script>