3 رای ثبت شده
برای استفاده از وب سرویس SOAP کافی است این سرویس را از یکی از آدرسهای زیر فراخوانی کنید و با توجه به توضیحات متد از آن استفاده کنید:
wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl |
non-wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx |
برای ارسال پیامک به یک یا چند گروه خاص از دفتر تلفن موجود در سامانه مدیریت پیام کوتاه خود در یک زمان معین از این متد استفاده کنید . با توجه به جدول ذیل پارامتر های این متد را مقدار دهی کنید .
آدرس وبسرویس
آدرس گیتهاب
نام پارامتر | نوع | اجباری/اختیاری | توضیح |
---|---|---|---|
UserName | String | اجباری | نام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password | String | اجباری | کلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
NumberGroupID | Long Integer | اجباری | شناسه گروه دفتر تلفن |
MessageBody | String | اجباری | متن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد |
SpecialNumber | String | اجباری | شماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید |
DontSendToRepeatedNumber | Boolean | اجباری | به شماره های تکراری ارسال نشود؟ در متد های ارسال به گروه شماره های دفتر تلفن ، برای جلوگیری از ارسال مکرر به شماره های که در گروه/گروه ها تکرار شده اند شما می توانید با استفاده از این پارامتر از ارسال تکراری جلوگیری کنید . اگر مقدار این پارامتر را برابر False قرار دهید پیامک ها به شماره های تکراری نیز ارسال می گردد ولی اگر مقدار آن را برابر True قرار دهید پیامک ها به شماره های تکرار ارسال نمی گردد . |
Year | Integer | اجباری | سال مورد نظر برای ارسال زمانبندی |
Month | Integer | اجباری | ماه مورد نظر برای ارسال زمانبندی |
Day | Integer | اجباری | روز مورد نظر برای ارسال زمانبندی |
Hour | Integer | اجباری | ساعت مورد نظر برای ارسال زمانبندی |
Minute | Integer | اجباری | دقیقه مورد نظر برای ارسال زمانبندی |
UserName از نوع String (اجباری) در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password از نوع String (اجباری) در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
NumberGroupID از نوع Long Integer (اجباری) شناسه گروه دفتر تلفن |
MessageBody از نوع String (اجباری) متن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد |
SpecialNumber از نوع String (اجباری) شماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید |
DontSendToRepeatedNumber از نوع Boolean (اجباری) به شماره های تکراری ارسال نشود؟ در متد های ارسال به گروه شماره های دفتر تلفن ، برای جلوگیری از ارسال مکرر به شماره های که در گروه/گروه ها تکرار شده اند شما می توانید با استفاده از این پارامتر از ارسال تکراری جلوگیری کنید . اگر مقدار این پارامتر را برابر False قرار دهید پیامک ها به شماره های تکراری نیز ارسال می گردد ولی اگر مقدار آن را برابر True قرار دهید پیامک ها به شماره های تکرار ارسال نمی گردد . |
Year از نوع Integer (اجباری) سال مورد نظر برای ارسال زمانبندی |
Month از نوع Integer (اجباری) ماه مورد نظر برای ارسال زمانبندی |
Day از نوع Integer (اجباری) روز مورد نظر برای ارسال زمانبندی |
Hour از نوع Integer (اجباری) ساعت مورد نظر برای ارسال زمانبندی |
Minute از نوع Integer (اجباری) دقیقه مورد نظر برای ارسال زمانبندی |
نوع خروجی | توضیحات |
---|---|
Long Integer | شناسه ارسال زمانبندی شده یا کد خطا |
در تمام متدهایی که مقدار String برمیگردانند ممکن است در مقدار بازگشتی ، عددی کوچکتر از 1000 و بزرگتر از 50 قرار گیرد ، در این صورت مقدار بازگشتی متد یک کد خطا می باشد و باید با توجه به جدول ذیل خطای موجود را پیدا کرده و در صورت امکان مشکل موجود را برطرف نمایید .
توجه : خود کد 50 به معنی موفقیت آمیز بودن عملیات ( Successful ) می باشد و این مقدار فقط در مقدار بازگشتی از متد InsertNumberInNumberGroup قرار می گیرد .
کد خطا | توضیحات |
---|---|
51 | نام کاربری یا رمز عبور اشتباه است |
52 | نام کاربری یا رمز عبور خالی است |
59 | کلید MessageBody خالی است |
60 | در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید |
61 | کلید SpecialNumber نامعتبر است ( شماره اختصاصی وارد شده وجود ندارد یا متعلق به این کاربر نمی باشد ) |
62 | کلید SpecialNumber خالی است |
63 | این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید ) |
70 | کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید ) |
72 | ترکیب پارامترهای زمان ( ترکیب Hour و Minute ) اشتباه است ( چنین زمانی وجود ندارد ) |
73 | ترکیب پارامترهای تاریخ ( ترکیب Year ، Month و Day ) اشتباه است ( چنین تاریخی وجود ندارد ( |
74 | طول کلید NumberGroupID بیش از حد مجاز است ( بیش از 1000 عدد است ) |
75 | کلید NumberGroupID خالی است |
76 | کلید NumberGroupID نامعتبر است ( مقدار آن Null است ) |
77 | شما کاربر وب سرویس نیستید |
78 | شما کاربر سامانه مدیریت ارسال و دریافت پیام کوتاه نیستید |
80 | در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید ) |
84 | شماره گروه دفتر تلفن (NumberGroupID ) نامعتبر است ( وجود ندارد یا توسط کاربر حذف شده است ) |
203 | به علت کمبود اعتبار پیام کوتاه شما توانایی ارسال به این شماره را ندارید ( پس از شارژ حساب دوباره ارسال کنید ) |
206 | شماره اپراتور نامعتبر می باشد |
300 | ارسال پیامک حاوی لینک مجاز نمی باشد ( توافقنامه ارسال لینک امضا نشده است) |
400 | تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است. |
666 | سرویس موقتاً غیر فعال است |
777 | این IP مسدود است |
888 | برای شماره فرستنده احراز هویت ثبت نشده است |
999 | ارسال این پیامک مجاز نیست |
<?php class SMS { public $Username = ''; public $Password = ''; private $SoapAddress = 'https://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl'; private $client; function __construct() { $this->client = new SoapClient($this->SoapAddress); } public Function GetClient(){ return $this->client; } public Function GetClientEx($option){ return new SoapClient($this->SoapAddress, $option); } public Function GetMethods(){ $arr = array(); $client = GetClient(); return $client->__getFunctions(); } public Function GetUserInfo() { $option = array('UserName'=> $this->Username,'Password'=> $this->Password); $client = $this->GetClient(); return $client->GetUserInfo($option)->GetUserInfoResult; } public Function SendNumberGroupSchedule($NumberGroupIDArray, $MessageBody, $SpecialNumber, $IsFlashMessage, $DontSendToRepeatedNumber, $Year, $Month, $Day, $Hour, $Minute){ $option = array('UserName'=> $this->Username,'Password'=> $this->Password, 'NumberGroupID'=> $NumberGroupIDArray, 'MessageBody'=> $MessageBody, 'SpecialNumber'=> $SpecialNumber, 'IsFlashMessage'=> $IsFlashMessage, 'DontSendToRepeatedNumber'=> $DontSendToRepeatedNumber, 'Year'=> $Year, 'Month'=> $Month, 'Day'=> $Day, 'Hour'=> $Hour, 'Minute'=> $Minute); $client = $this->GetClient(); return $client->SendNumberGroupSchedule($option)->SendNumberGroupScheduleResult; } } ?>
/** Send Number Group Schedule @param UserName String @param Password String @param NumberGroupID long[] GroupIDs @param Message Text of your SMS @param SpecialNumber Your Special number ,send sms from this number @param IsFlash True/False @param DontSendToRepeatedNumber True/False @param Year int @param Month int @param Day int @param Hour int @param Minute int @return SendID for Send To Group */ public final long SendNumberGroupSchedule(String UserName, String Password, long[] NumberGroupID, String Message, String SpecialNumber, boolean IsFlash, boolean DontSendToRepeatedNumber, int Year, int Month, int Day, int Hour, int Minute) { try (SOAP.SMS SMSService = new SOAP.SMS()) { return SMSService.SendNumberGroupSchedule(UserName, Password, NumberGroupID, Message, SpecialNumber, IsFlash, DontSendToRepeatedNumber, Year, Month, Day, Hour, Minute); } catch (RuntimeException ex){} }
public static class API { /// <summary> /// Send Number Group Schedule /// </summary> /// <param name="UserName">String</param> /// <param name="Password">String</param> /// <param name="NumberGroupID">long[] GroupIDs</param> /// <param name="Message">Text of your SMS</param> /// <param name="SpecialNumber">Your Special number ,send sms from this number</param> /// <param name="IsFlash">True/False</param> /// <param name="DontSendToRepeatedNumber">True/False</param> /// <param name="Year">int</param> /// <param name="Month">int</param> /// <param name="Day">int</param> /// <param name="Hour">int</param> /// <param name="Minute">int</param> /// <returns>SendID for Send To Group</returns> public static long SendNumberGroupSchedule(string UserName, string Password, long[] NumberGroupID, string Message, string SpecialNumber, bool IsFlash, bool DontSendToRepeatedNumber, int Year, int Month, int Day, int Hour, int Minute) { using (SOAP.SMS SMSService = new SOAP.SMS()) { return SMSService.SendNumberGroupSchedule(UserName, Password, NumberGroupID, Message, SpecialNumber, IsFlash, DontSendToRepeatedNumber, Year, Month, Day, Hour, Minute); } } }
Imports System.Net Imports System.IO Imports System.Text Imports System.Web.Script.Serialization public Class API ''' <summary> ''' Send Number Group Schedule ''' </summary> ''' <param name="UserName">String</param> ''' <param name="Password">String</param> ''' <param name="NumberGroupID">long[] GroupIDs</param> ''' <param name="Message">Text of your SMS</param> ''' <param name="SpecialNumber">Your Special number ,send sms from this number</param> ''' <param name="IsFlash">True/False</param> ''' <param name="DontSendToRepeatedNumber">True/False</param> ''' <param name="Year">int</param> ''' <param name="Month">int</param> ''' <param name="Day">int</param> ''' <param name="Hour">int</param> ''' <param name="Minute">int</param> ''' <returns>SendID for Send To Group</returns> public Shared Function SendNumberGroupSchedule(UserName As String, Password As String, NumberGroupID As Long(), Message As String, SpecialNumber As String, IsFlash As Boolean, _ DontSendToRepeatedNumber As Boolean, Year As Integer, Month As Integer, Day As Integer, Hour As Integer, Minute As Integer) As Long Using SMSService As New SOAP.SMS() Return SMSService.SendNumberGroupSchedule(UserName, Password, NumberGroupID, Message, SpecialNumber, IsFlash, _ DontSendToRepeatedNumber, Year, Month, Day, Hour, Minute) End Using End Function End Class
همیشه آماده ارائه راهکار به شما هستیم
هزینه تماس برای شما رایگان است، هزینه تماس را ما پرداخت میکنیم
شرکت فناوری اطلاعات و ارتباطات راه آفتاب با نام تجاری SunWay ICT Center ثبت شده به شماره ۸۵۰۵ در مورخ ۵ آبان ۱۳۸۲ در اداره ثبت شرکت ها و دارای مجوز فعالیت به شماره ۲۶۰۱۰۰۱۶ از سازمان نظام صنفی رایانه ایی کشور ، در بدو تاسیس فعالیت های خود را در زمینه فناوری اطلاعات و ارتباطات آغاز نموده و همواره با جذب نیروهای متخصص و شایسته سعی در ایجاد سازمانی پویا، خلاق، چابک و دانش محور را داشته است.
با ما تماس بگیرید، کارشناسان ما آماده پاسخگویی میباشند یا فرم زیر را ثبت کنید، همکاران ما با شما تماس خواهند گرفت.
تمامی حقوق معنوی مالکیت این وبسایت برای شرکت راه آفتاب محفوظ است.
خیلی زود با شما تماس خواهیم گرفت
از طریق تلفن و واتساپ هم میتوانید با ما تماس بگیرید
در کمتر از یک دقیقه یک سامانه پیامک و وبسرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید