1 رای ثبت شده
برای استفاده از وب سرویس 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=GetInboxMessageWithInboxID&username=$UserName$&password=$Password$&NumberOfMessage=$NumberOfMessage$&InboxID=$InboxID$&IsReaded=$IsReaded$
آدرس وبسرویس
آدرس گیتهاب
نام پارامتر | نوع | اجباری/اختیاری | توضیح |
---|---|---|---|
UserName | String | اجباری | نام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password | String | اجباری | کلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
NumberOfMessage | Integer | اجباری | تعداد پیامک های درخواستی |
InboxID | Integer | اجباری | شناسه پیامک |
IsReaded | Boolean | اجباری | آیا تمامی پیامک ها نمایش داده شود یا فقط خوانده نشده ها؟ در متد دریافت پیامک های ورودی جهت دسترسی به تمامی پیامک های دریافتی یا فقط پیامک های دریافتی خوانده نشده به کار می رود. اگر مقدار این پارامتر را برابر False قرار دهید تنها پیامک های دریافتی که خوانده نشده اند نمایش داده می شود ولی اگر مقدار آن را برابر با True قرار دهید تمامی پیامک ها شامل پیامک های خوانده شده و خوانده نشده نمایش داده می شود . |
UserName از نوع String (اجباری) در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password از نوع String (اجباری) در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
NumberOfMessage از نوع Integer (اجباری) تعداد پیامک های درخواستی |
InboxID از نوع Integer (اجباری) شناسه پیامک |
IsReaded از نوع Boolean (اجباری) آیا تمامی پیامک ها نمایش داده شود یا فقط خوانده نشده ها؟ در متد دریافت پیامک های ورودی جهت دسترسی به تمامی پیامک های دریافتی یا فقط پیامک های دریافتی خوانده نشده به کار می رود. اگر مقدار این پارامتر را برابر False قرار دهید تنها پیامک های دریافتی که خوانده نشده اند نمایش داده می شود ولی اگر مقدار آن را برابر با True قرار دهید تمامی پیامک ها شامل پیامک های خوانده شده و خوانده نشده نمایش داده می شود . |
نوع خروجی | توضیحات |
---|---|
خروجی Json | آرایه Messages شامل اطلاعات پیامک های دریافتی - InboxID شناسه پیامک دریافتی - SpecialNumber شماره اختصاصی ( شماره ای پیامک را دریافت کرده است ) - SenderNumber شماره فرستنده ( شماره موبایل فرستنده پیامک ) - MessageBody متن پیامک - ReceiveDate تاریخ و ساعت دریافت پیامک - UDH سرآیند پیامک دریافتی - Status کد خطا (رجوع شود به بخش 5) |
کد | توضیحات |
---|---|
0 | شناسه پیامک نامعتبر است ( یا ممکن است شناسه پیامک ارسال شده مربوط به پیامکی باشد که بیش از یک ماه از ارسال آن می گذرد ) وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود |
1 | هنوز وضعیتی دریافت نشده است ، سیستم در حال پیگیری وضعیت پیامک از مخابرات است می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد |
2 | پیامک به موبایل گیرنده رسیده است وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود |
3 | پیامک به موبایل گیرنده نرسیده است ، به یکی از دلایل ذیل :
|
4 | پیامک به مرکز مخابراتی رسیده است ( در صف ارسال مخابرات قرار گرفته است و بزودی به موبایل گیرنده ارسال می گردد ) می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد |
5 | پیامک به مرکز مخابراتی نرسیده است ( این وضعیت زمانی رخ می دهد که مرکز مخابراتی نتواند به اپراتور تلفن همراه شماره گیرنده ، پیامک ارسال کند ) وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود |
6 | شماره موبایل گیرنده پیامک به درخواست کاربر در لیست غیر فعال مخابرات قرار گرفته است هزینه این ارسال به کاربر برگردانده می شود وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود |
7 | پیامک در صف ارسال قرار دارد ( سرور هنوز شروع به ارسال پیامک نکرده است ) می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد |
8 | سرور در حال ارسال پیامک می باشد می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد |
9 | در زمان ارسال به علت کمبود اعتبار پیام کوتاه ، این پیامک ارسال نشده است وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود |
10 | پیامک ارسال نشده است ( به دلیل اختلالات ارتباطی پیامک ارسال نشده است اما سرور به مدت 2 ساعت تلاش به ارسال مجدد این پیامک می کند و اگر طی این 2 ساعت نتواند پیامک را ارسال کند ، هزینه آن را به کاربر برمی گرداند می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد |
11 | پیامک هنوز توسط اپراتور تأیید نشده است می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد |
12 | پیامک در لیست کنسل شده یا فیلتر شده قرار دارد وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود |
در تمام متدهایی که مقدار String برمیگردانند ممکن است در مقدار بازگشتی ، عددی کوچکتر از 1000 و بزرگتر از 50 قرار گیرد ، در این صورت مقدار بازگشتی متد یک کد خطا می باشد و باید با توجه به جدول ذیل خطای موجود را پیدا کرده و در صورت امکان مشکل موجود را برطرف نمایید .
توجه : خود کد 50 به معنی موفقیت آمیز بودن عملیات ( Successful ) می باشد و این مقدار فقط در مقدار بازگشتی از متد InsertNumberInNumberGroup قرار می گیرد .
کد خطا | توضیحات |
---|---|
51 | نام کاربری یا رمز عبور اشتباه است |
52 | نام کاربری یا رمز عبور خالی است |
60 | در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید |
63 | این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید ) |
65 | کلید NumberOfMessage اشتباه است ( مقدار آن منفی است ) |
70 | کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید ) |
77 | شما کاربر وب سرویس نیستید |
80 | در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید ) |
400 | تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است. |
666 | سرویس موقتاً غیر فعال است |
777 | این IP مسدود است |
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 GetInboxMessageWithInboxID($UserName, $Password, $NumberOfMessage, $InboxID, $IsReaded) { $result= $this->get_data("service=GetInboxMessageWithInboxID&UserName=" . urlencode($UserName) . "&Password=" . urlencode($Password) . "&NumberOfMessage=" . urlencode($NumberOfMessage) . "&InboxID=" . urlencode($InboxID) . "&IsReaded=" . urlencode(($IsReaded ? "true" : "false"))); return(json_decode($result)); } }
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 ResultInbox GetInboxMessageWithInboxID(String UserName, String Password, int NumberOfMessage, int InboxID, Boolean IsReaded) throws Exception { String result = getUrl("service=GetInboxMessageWithInboxID&UserName=" + encode(UserName) + "&Password=" + encode(Password) + "&NumberOfMessage=" + encode(NumberOfMessage) + "&InboxID=" + encode(InboxID) + "&IsReaded=" + encode((IsReaded ? "true" : "false"))); ResultInbox resultInbox = gson.fromJson(result, ResultInbox.class); return resultInbox; } }
public static class API { const string URL = "https://sms.sunwaysms.com/smsws/HttpService.ashx?"; /// <summary> /// Get Inbox Message With Last InboxID /// </summary> /// <param name="UserName">String</param> /// <param name="Password">String</param> /// <param name="NumberOfMessage">int</param> /// <param name="InboxID">int</param> /// <param name="IsReaded">True/False</param> /// <returns>ResultInbox</returns> public static ResultInbox GetInboxMessageWithInboxID(string UserName, string Password, int NumberOfMessage, int InboxID, bool IsReaded) { WebRequest request = WebRequest.Create(URL + "service=GetInboxMessageWithInboxID&UserName=" + UserName + "&Password=" + Password + "&NumberOfMessage=" + NumberOfMessage + "&InboxID=" + InboxID + "&IsReaded=" + (IsReaded ? "true" : "false")); request.Method = "GET"; WebResponse response = request.GetResponse(); using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8)) { var result = reader.ReadToEnd(); JavaScriptSerializer serializer = new JavaScriptSerializer(); return serializer.Deserialize<ResultInbox>(result); } } }
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> ''' Get Inbox Message With Last InboxID ''' </summary> ''' <param name="UserName">String</param> ''' <param name="Password">String</param> ''' <param name="NumberOfMessage">int</param> ''' <param name="InboxID">int</param> ''' <param name="IsReaded">True/False</param> ''' <returns>ResultInbox</returns> Public Shared Function GetInboxMessageWithInboxID(UserName As String, Password As String, NumberOfMessage As Integer, InboxID As Integer, IsReaded As Boolean) As ResultInbox Dim request As WebRequest = WebRequest.Create(URL & "service=GetInboxMessageWithInboxID&UserName=" & UserName & "&Password=" & Password & "&NumberOfMessage=" & NumberOfMessage & "&InboxID=" & InboxID & "&IsReaded=" & (If(IsReaded, "true", "false"))) request.Method = "GET" Dim response As WebResponse = request.GetResponse() Using reader As New StreamReader(response.GetResponseStream(), Encoding.UTF8) Dim result = reader.ReadToEnd() Dim serializer As New JavaScriptSerializer() Return serializer.Deserialize(Of ResultInbox)(result) End Using End Function End Class
همیشه آماده ارائه راهکار به شما هستیم
هزینه تماس برای شما رایگان است، هزینه تماس را ما پرداخت میکنیم
شرکت فناوری اطلاعات و ارتباطات راه آفتاب با نام تجاری SunWay ICT Center ثبت شده به شماره ۸۵۰۵ در مورخ ۵ آبان ۱۳۸۲ در اداره ثبت شرکت ها و دارای مجوز فعالیت به شماره ۲۶۰۱۰۰۱۶ از سازمان نظام صنفی رایانه ایی کشور ، در بدو تاسیس فعالیت های خود را در زمینه فناوری اطلاعات و ارتباطات آغاز نموده و همواره با جذب نیروهای متخصص و شایسته سعی در ایجاد سازمانی پویا، خلاق، چابک و دانش محور را داشته است.
با ما تماس بگیرید، کارشناسان ما آماده پاسخگویی میباشند یا فرم زیر را ثبت کنید، همکاران ما با شما تماس خواهند گرفت.
تمامی حقوق معنوی مالکیت این وبسایت برای شرکت راه آفتاب محفوظ است.
خیلی زود با شما تماس خواهیم گرفت
از طریق تلفن و واتساپ هم میتوانید با ما تماس بگیرید
در کمتر از یک دقیقه یک سامانه پیامک و وبسرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید