3 رای ثبت شده
برای استفاده از وب سرویس SOAP کافی است این سرویس را از یکی از آدرسهای زیر فراخوانی کنید و با توجه به توضیحات متد از آن استفاده کنید:
wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl |
non-wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx |
برای ارسال پیامک ، به یک/چند شماره از این متد استفاده کنید . با توجه به جدول ذیل پارامتر های این متد را مقدار دهی کنید . خروجی این متد شناسه پیامک های ارسال شده است که مقدار آن به صورت یک آرایه از اعداد بزرگتر از 1000 می باشد ، اگر مقدار عدد بازگشتی کمتر از 1000 باشد به معنی بروز خطا در ارسال است . جهت به کارگیری آن آدرس URL زیر را فراخوانی نمایید:
https://sms.sunwaysms.com/smsws/HttpService.ashx?service=SendArray&username=$UserName$&password=$Password$&to=$RecipientNumber$&message=$MessageBody$&from=$SpecialNumber&$chkMessageId=$CheckingMessageID$
آدرس وبسرویس
آدرس گیتهاب
نام پارامتر | نوع | اجباری/اختیاری | توضیح |
---|---|---|---|
UserName | String | اجباری | نام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password | String | اجباری | کلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
RecipientNumber | String | اجباری | شماره گیرنده ویا گیرندگان ( شماره تلفن همراه مقصد ) آرایه ای از شماره موبایل های افراد گیرنده پیامک . شما می توانید در این آرایه حداقل 1 و حداکثر 1000 عدد شماره موبایل گیرنده را جهت ارسال پیامک قرار دهید . توجه داشته باشید که فرمت شماره می بایست به یکی از شکل های زیر تعریف شود : ( در حال حاضر این سیستم توانایی ارسال پیامک به تمام اپراتورهای معتبر پیام کوتاه را دارد ) 0912??????? پیشنهاد می شود از این حالت استفاده کنید - یازده کاراکتر 98912??????? دوازده کاراکتر 912??????? ده کاراکتر |
MessageBody | String | اجباری | متن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد |
SpecialNumber | String | اجباری | شماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید |
CheckingMessageID | String | اختیاری | شناسه پیامک کاربر |
UserName از نوع String (اجباری) در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password از نوع String (اجباری) در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
RecipientNumber از نوع String (اجباری) شماره گیرنده ویا گیرندگان ( شماره تلفن همراه مقصد ) آرایه ای از شماره موبایل های افراد گیرنده پیامک . شما می توانید در این آرایه حداقل 1 و حداکثر 1000 عدد شماره موبایل گیرنده را جهت ارسال پیامک قرار دهید . توجه داشته باشید که فرمت شماره می بایست به یکی از شکل های زیر تعریف شود : ( در حال حاضر این سیستم توانایی ارسال پیامک به تمام اپراتورهای معتبر پیام کوتاه را دارد ) 0912??????? پیشنهاد می شود از این حالت استفاده کنید - یازده کاراکتر 98912??????? دوازده کاراکتر 912??????? ده کاراکتر |
MessageBody از نوع String (اجباری) متن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد |
SpecialNumber از نوع String (اجباری) شماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید |
CheckingMessageID از نوع String (اختیاری) شناسه پیامک کاربر |
نوع خروجی | توضیحات |
---|---|
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 های تایید شده بفرمایید ) |
66 | طول کلید CheckingMessageID با طول کلید RecipientNumber برابر نیست |
67 | طول آرایه CheckingMessageID بیش از حد مجاز است ( بیش از 50 عدد است ) |
68 | کلید CheckingMessageID خالی است |
69 | کلید CheckingMessageID نامعتبر است ( مقدار آن Null است ) |
70 | کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید ) |
77 | شما کاربر وب سرویس نیستید |
78 | شما کاربر سامانه مدیریت ارسال و دریافت پیام کوتاه نیستید |
80 | در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید ) |
201 | فرمت شماره RecipientNumber اشتباه است |
202 | اپراتور مخابراتی شماره RecipientNumber برای سیستم ناشناخته است |
203 | به علت کمبود اعتبار پیام کوتاه شما توانایی ارسال به این شماره را ندارید ( پس از شارژ حساب دوباره ارسال کنید ) |
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 SendArray($UserName, $Password, $RecipientNumber, $Message, $SpecialNumber, $IsFlash, $CheckingMessageID) { $Number = ""; $chkMessageID = ""; foreach ($RecipientNumber as $item) { $Number = $Number . $item . ","; } foreach ($CheckingMessageID as $item) { $chkMessageID = $chkMessageID . $item . ","; } return $this->get_data("service=SendArray&UserName=" . urlencode($UserName) . "&Password=" . urlencode($Password) . "&To=" . urlencode(rtrim($Number,",")) . "&Message=" . urlencode($Message) . "&From=" . urlencode($SpecialNumber) . "&Flash=" . urlencode(($IsFlash ? "true" : "false")) . "&chkMessageId=" . urlencode(rtrim($chkMessageID,","))); } }
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[] SendArray(String UserName, String Password, String[] RecipientNumber, String Message, String SpecialNumber, Boolean IsFlash, long[] CheckingMessageID) throws Exception { String recipientNumber = "", checkingMessageID = ""; for (String item : RecipientNumber) { recipientNumber += item + ","; } for (long item : CheckingMessageID) { checkingMessageID += item + ","; } String result = getUrl("service=SendArray&UserName=" + encode(UserName) + "&Password=" + encode(Password) + "&To=" + encode(rtrim(recipientNumber)) + "&Message=" + encode(Message) + "&From=" + encode(SpecialNumber) + "&Flash=" + encode((IsFlash ? "true" : "false")) + "&chkMessageId=" + encode(rtrim(checkingMessageID))); return toArrayOfLong(result); } }
public static class API { const string URL = "https://sms.sunwaysms.com/smsws/HttpService.ashx?"; /// <summary> /// Send Array /// </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">Your Special number ,send sms from this number</param> /// <param name="IsFlash">True/False</param> /// <param name="CheckingMessageID">Your local ID for message</param> /// <returns>MessageID for each SMS</returns> public static long[] SendArray(string UserName, string Password, string[] RecipientNumber, string Message, string SpecialNumber, bool IsFlash, long[] CheckingMessageID) { string recipientNumber = "", checkingMessageID = ""; foreach (var item in RecipientNumber) { recipientNumber += item + ","; } foreach (var item in CheckingMessageID) { checkingMessageID += item + ","; } WebRequest request = WebRequest.Create(URL + "service=SendArray&UserName=" + UserName + "&Password=" + Password + "&To=" + recipientNumber.TrimEnd(',') + "&Message=" + Message + "&From=" + SpecialNumber + "&Flash=" + (IsFlash ? "true" : "false") + "&chkMessageId=" + checkingMessageID.TrimEnd(',')); request.Method = "GET"; WebResponse response = request.GetResponse(); using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8)) { var result = reader.ReadToEnd(); return (result ?? "").Split(new char[] { ',' }, StringSplitOptions.RemoveEmptyEntries).Select(s => { var out_int = 0L; long.TryParse(s.Trim(), out out_int); return out_int; }).ToArray(); } } }
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 ''' </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">Your Special number ,send sms from this number</param> ''' <param name="IsFlash">True/False</param> ''' <param name="CheckingMessageID">Your local ID for message</param> ''' <returns>MessageID for each SMS</returns> Public Shared Function SendArray(UserName As String, Password As String, RecipientNumber As String(), Message As String, SpecialNumber As String, IsFlash As Boolean, CheckingMessageID As Long()) As Long() Dim _recipientNumber As String = "", checkingMessageID__4 As String = "" For Each item As Long In RecipientNumber _recipientNumber += item & "," Next For Each item As Long In CheckingMessageID checkingMessageID__4 += item & "," Next Dim request As WebRequest = WebRequest.Create(URL & "service=SendArray&UserName=" & UserName & "&Password=" & Password & "&To=" & _recipientNumber.TrimEnd(","c) & "&Message=" & Message & "&From=" & SpecialNumber & "&Flash=" & (If(IsFlash, "true", "false")) & "&chkMessageId=" & checkingMessageID__4.TrimEnd(","c)) request.Method = "GET" Dim response As WebResponse = request.GetResponse() Using reader As New StreamReader(response.GetResponseStream(), Encoding.UTF8) Dim result = reader.ReadToEnd() Return (If(result, "")).Split(New Char() {","c}, StringSplitOptions.RemoveEmptyEntries).[Select](Function(s) Dim out_int = 0L Long.TryParse(s.Trim(), out_int) Return out_int End Function).ToArray() End Using End Function End Class
همیشه آماده ارائه راهکار به شما هستیم
هزینه تماس برای شما رایگان است، هزینه تماس را ما پرداخت میکنیم
شرکت فناوری اطلاعات و ارتباطات راه آفتاب با نام تجاری SunWay ICT Center ثبت شده به شماره ۸۵۰۵ در مورخ ۵ آبان ۱۳۸۲ در اداره ثبت شرکت ها و دارای مجوز فعالیت به شماره ۲۶۰۱۰۰۱۶ از سازمان نظام صنفی رایانه ایی کشور ، در بدو تاسیس فعالیت های خود را در زمینه فناوری اطلاعات و ارتباطات آغاز نموده و همواره با جذب نیروهای متخصص و شایسته سعی در ایجاد سازمانی پویا، خلاق، چابک و دانش محور را داشته است.
با ما تماس بگیرید، کارشناسان ما آماده پاسخگویی میباشند یا فرم زیر را ثبت کنید، همکاران ما با شما تماس خواهند گرفت.
تمامی حقوق معنوی مالکیت این وبسایت برای شرکت راه آفتاب محفوظ است.
خیلی زود با شما تماس خواهیم گرفت
از طریق تلفن و واتساپ هم میتوانید با ما تماس بگیرید
در کمتر از یک دقیقه یک سامانه پیامک و وبسرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید