2 رای ثبت شده
برای استفاده از وب سرویس SOAP کافی است این سرویس را از یکی از آدرسهای زیر فراخوانی کنید و با توجه به توضیحات متد از آن استفاده کنید:
wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl |
non-wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx |
برای ارسال پیامک به صورت زمانبندی شده ، به یک/چند شماره از این متد استفاده کنید . جهت به کارگیری آن آدرس URL زیر را فراخوانی نمایید :
https://sms.sunwaysms.com/smsws/HttpService.ashx?service=SendArraySchedule&username=$UserName$&password=$Password$&to=$RecipientNumber$&message=$MessageBody$&from=$SpecialNumber$&year=$Year$&month=$Month$&day=$Day$&hour=$Hour$&minute=$Minute$
آدرس وبسرویس
آدرس گیتهاب
نام پارامتر | نوع | اجباری/اختیاری | توضیح |
---|---|---|---|
UserName | String | اجباری | نام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password | String | اجباری | کلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
RecipientNumber | String | اجباری | شماره گیرنده ویا گیرندگان ( شماره تلفن همراه مقصد ) آرایه ای از شماره موبایل های افراد گیرنده پیامک . شما می توانید در این آرایه حداقل 1 و حداکثر 1000 عدد شماره موبایل گیرنده را جهت ارسال پیامک قرار دهید . توجه داشته باشید که فرمت شماره می بایست به یکی از شکل های زیر تعریف شود : ( در حال حاضر این سیستم توانایی ارسال پیامک به تمام اپراتورهای معتبر پیام کوتاه را دارد ) 0912??????? پیشنهاد می شود از این حالت استفاده کنید - یازده کاراکتر 98912??????? دوازده کاراکتر 912??????? ده کاراکتر |
MessageBody | String | اجباری | متن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد |
SpecialNumber | String | اجباری | شماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید |
Year | Integer | اجباری | سال مورد نظر برای ارسال زمانبندی |
Month | Integer | اجباری | ماه مورد نظر برای ارسال زمانبندی |
Day | Integer | اجباری | روز مورد نظر برای ارسال زمانبندی |
Hour | Integer | اجباری | ساعت مورد نظر برای ارسال زمانبندی |
Minute | Integer | اجباری | دقیقه مورد نظر برای ارسال زمانبندی |
UserName از نوع String (اجباری) در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password از نوع String (اجباری) در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
RecipientNumber از نوع String (اجباری) شماره گیرنده ویا گیرندگان ( شماره تلفن همراه مقصد ) آرایه ای از شماره موبایل های افراد گیرنده پیامک . شما می توانید در این آرایه حداقل 1 و حداکثر 1000 عدد شماره موبایل گیرنده را جهت ارسال پیامک قرار دهید . توجه داشته باشید که فرمت شماره می بایست به یکی از شکل های زیر تعریف شود : ( در حال حاضر این سیستم توانایی ارسال پیامک به تمام اپراتورهای معتبر پیام کوتاه را دارد ) 0912??????? پیشنهاد می شود از این حالت استفاده کنید - یازده کاراکتر 98912??????? دوازده کاراکتر 912??????? ده کاراکتر |
MessageBody از نوع String (اجباری) متن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد |
SpecialNumber از نوع String (اجباری) شماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید |
Year از نوع Integer (اجباری) سال مورد نظر برای ارسال زمانبندی |
Month از نوع Integer (اجباری) ماه مورد نظر برای ارسال زمانبندی |
Day از نوع Integer (اجباری) روز مورد نظر برای ارسال زمانبندی |
Hour از نوع Integer (اجباری) ساعت مورد نظر برای ارسال زمانبندی |
Minute از نوع Integer (اجباری) دقیقه مورد نظر برای ارسال زمانبندی |
نوع خروجی | توضیحات |
---|---|
String | شناسه ارسال زمانبندی شده یا کد خطا |
در تمام متدهایی که مقدار String برمیگردانند ممکن است در مقدار بازگشتی ، عددی کوچکتر از 1000 و بزرگتر از 50 قرار گیرد ، در این صورت مقدار بازگشتی متد یک کد خطا می باشد و باید با توجه به جدول ذیل خطای موجود را پیدا کرده و در صورت امکان مشکل موجود را برطرف نمایید .
توجه : خود کد 50 به معنی موفقیت آمیز بودن عملیات ( Successful ) می باشد و این مقدار فقط در مقدار بازگشتی از متد InsertNumberInNumberGroup قرار می گیرد .
کد خطا | توضیحات |
---|---|
51 | نام کاربری یا رمز عبور اشتباه است |
52 | نام کاربری یا رمز عبور خالی است |
53 | طول کلید RecipientNumber بیش از حد مجاز است ( بیش از 1000 عدد است ) |
54 | کلید RecipientNumber خالی است |
55 | کلید RecipientNumber نامعتبر است ( مقدار آن Null است ) |
59 | کلید MessageBody خالی است |
60 | در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید |
61 | کلید SpecialNumber نامعتبر است ( شماره اختصاصی وارد شده وجود ندارد یا متعلق به این کاربر نمی باشد ) |
62 | کلید SpecialNumber خالی است |
63 | این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید ) |
70 | کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید ) |
72 | ترکیب پارامترهای زمان ( ترکیب Hour و Minute ) اشتباه است ( چنین زمانی وجود ندارد ) |
73 | ترکیب پارامترهای تاریخ ( ترکیب Year ، Month و Day ) اشتباه است ( چنین تاریخی وجود ندارد ( |
77 | شما کاربر وب سرویس نیستید |
78 | شما کاربر سامانه مدیریت ارسال و دریافت پیام کوتاه نیستید |
80 | در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید ) |
201 | فرمت شماره RecipientNumber اشتباه است |
202 | اپراتور مخابراتی شماره RecipientNumber برای سیستم ناشناخته است |
203 | به علت کمبود اعتبار پیام کوتاه شما توانایی ارسال به این شماره را ندارید ( پس از شارژ حساب دوباره ارسال کنید ) |
204 | هیچ شناسه ای با مقدار CheckingMessageID در سیستم وجود ندارد |
205 | فرمت شماره PersonNumber اشتباه است |
206 | شماره اپراتور نامعتبر می باشد |
300 | ارسال پیامک حاوی لینک مجاز نمی باشد ( توافقنامه ارسال لینک امضا نشده است) |
400 | تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است. |
666 | سرویس موقتاً غیر فعال است |
777 | این IP مسدود است |
888 | برای شماره فرستنده احراز هویت ثبت نشده است |
999 | ارسال این پیامک مجاز نیست |
class SMS { function get_data($Data) { $url = "https://sms.sunwaysms.com/smsws/HttpService.ashx?"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url . $Data); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $timeout); $data = curl_exec($ch); curl_close($ch); return $data; } function SendArraySchedule($UserName, $Password, $RecipientNumber, $Message, $SpecialNumber, $IsFlash, $Year, $Month, $Day, $Hour, $Minute) { $Number = ""; foreach ($RecipientNumber as $item) { $Number = $Number . $item . ","; } return $this->get_data("service=SendArraySchedule&UserName=" . urlencode($UserName) . "&Password=" . urlencode($Password) . "&To=" . urlencode(rtrim($Number,",")) . "&Message=" . urlencode($Message) . "&From=" . urlencode($SpecialNumber) . "&Flash=" . urlencode(($IsFlash ? "true" : "false")) . "&Year=" . urlencode($Year) . "&Month=" . urlencode($Month) . "&Day=" . urlencode($Day) . "&Hour=" . urlencode($Hour) . "&Minute=" . urlencode($Minute)); } }
import java.net.*; import java.nio.charset.Charset; import java.io.*; import com.google.gson.*; public class UrlAPI { wp-content String link = "https://sms.sunwaysms.com/smsws/HttpService.ashx?"; wp-content Gson gson = new Gson(); public static void main(String[] args) { } public static String getUrl(String Url) throws Exception { String temp = ""; try { URL url = new URL(link + Url); // Get the response URLConnection urlConnection = url.openConnection(); BufferedReader reader = new BufferedReader(new InputStreamReader( urlConnection.getInputStream(), Charset.forName("UTF-8"))); String line = ""; while ((line = reader.readLine()) != null) { temp += line; } } catch (IOException e) { e.printStackTrace(); } return temp; } public static long SendArraySchedule(String UserName, String Password, String[] RecipientNumber, String Message, String SpecialNumber, Boolean IsFlash, int Year, int Month, int Day, int Hour, int Minute) throws Exception { String recipientNumber = ""; for (String item : RecipientNumber) { recipientNumber += item + ","; } String result = getUrl("service=SendArraySchedule&UserName=" + encode(UserName) + "&Password=" + encode(Password) + "&To=" + encode(rtrim(recipientNumber)) + "&Message=" + encode(Message) + "&From=" + encode(SpecialNumber) + "&Flash=" + encode((IsFlash ? "true" : "false")) + "&Year=" + encode(Year) + "&Month=" + encode(Month) + "&Day=" + encode(Day) + "&Hour=" + encode(Hour) + "&Minute=" + encode(Minute)); return Long.parseLong(result); } }
public static class API { const string URL = "https://sms.sunwaysms.com/smsws/HttpService.ashx?"; /// <summary> /// Send Array Schedule /// </summary> /// <param name="UserName">String</param> /// <param name="Password">String</param> /// <param name="RecipientNumber">Send SMS to this numbers</param> /// <param name="Message">Text of your SMS</param> /// <param name="SpecialNumber"></param> /// <param name="IsFlash">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>MessageID</returns> public static long SendArraySchedule(string UserName, string Password, string[] RecipientNumber, string Message, string SpecialNumber, bool IsFlash, int Year, int Month, int Day, int Hour, int Minute) { string recipientNumber = ""; foreach (var item in RecipientNumber) { recipientNumber += item + ","; } WebRequest request = WebRequest.Create(URL + "service=SendArraySchedule&UserName=" + UserName + "&Password=" + Password + "&To=" + recipientNumber.TrimEnd(',') + "&Message=" + Message + "&From=" + SpecialNumber + "&Flash=" + (IsFlash ? "true" : "false") + "&Year=" + Year + "&Month=" + Month + "&Day=" + Day + "&Hour=" + Hour + "&Minute=" + Minute); request.Method = "GET"; WebResponse response = request.GetResponse(); using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8)) { var result = reader.ReadToEnd(); var out_int = 0L; long.TryParse(result.Trim(), out out_int); return out_int; } } }
Imports System.Net Imports System.IO Imports System.Text Imports System.Web.Script.Serialization Public Class API Const URL As String = "https://sms.sunwaysms.com/smsws/HttpService.ashx?" ''' <summary> ''' Send Array Schedule ''' </summary> ''' <param name="UserName">String</param> ''' <param name="Password">String</param> ''' <param name="RecipientNumber">Send SMS to this numbers</param> ''' <param name="Message">Text of your SMS</param> ''' <param name="SpecialNumber"></param> ''' <param name="IsFlash">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>MessageID</returns> Public Shared Function SendArraySchedule(UserName As String, Password As String, RecipientNumber As String(), Message As String, SpecialNumber As String, IsFlash As Boolean, _ Year As Integer, Month As Integer, Day As Integer, Hour As Integer, Minute As Integer) As Long Dim _recipientNumber As String = "" For Each item As Long In RecipientNumber _recipientNumber += item & "," Next Dim request As WebRequest = WebRequest.Create(URL & "service=SendArraySchedule&UserName=" & UserName & "&Password=" & Password & "&To=" & _recipientNumber.TrimEnd(","c) & "&Message=" & Message & "&From=" & SpecialNumber & "&Flash=" & (If(IsFlash, "true", "false")) & "&Year=" & Year & "&Month=" & Month & "&Day=" & Day & "&Hour=" & Hour & "&Minute=" & Minute) request.Method = "GET" Dim response As WebResponse = request.GetResponse() Using reader As New StreamReader(response.GetResponseStream(), Encoding.UTF8) Dim result = reader.ReadToEnd() Dim out_int = 0L Long.TryParse(result.Trim(), out_int) Return out_int End Using End Function End Class
خیلی زود با شما تماس خواهیم گرفت
از طریق تلفن و واتساپ هم میتوانید با ما تماس بگیرید
در کمتر از یک دقیقه یک سامانه پیامک و وبسرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید