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=InsertNumberInNumberGroup&username=$UserName$&password=$Password$&NumberGroupID=$NumberGroupID$&PersonNumber=$PersonNumber$&PersonName=$PersonName$
آدرس وبسرویس
آدرس گیتهاب
نام پارامتر | نوع | اجباری/اختیاری | توضیح |
---|---|---|---|
UserName | String | اجباری | نام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password | String | اجباری | کلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
NumberGroupID | Long Integer | اجباری | شناسه گروه دفتر تلفن |
PersonNumber | Array Of String | اجباری | شماره افراد مورد نظر |
PersonName | Array Of String | اجباری | نام افراد مورد نظر |
UserName از نوع String (اجباری) در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد ) |
Password از نوع String (اجباری) در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد ) |
NumberGroupID از نوع Long Integer (اجباری) شناسه گروه دفتر تلفن |
PersonNumber از نوع Array Of String (اجباری) شماره افراد مورد نظر |
PersonName از نوع Array Of String (اجباری) نام افراد مورد نظر |
نوع خروجی | توضیحات |
---|---|
String | آرایه ای که نشان دهنده موفقیت آمیز بودن ثبت و یا کدهای خطا می باشد |
در تمام متدهایی که مقدار String برمیگردانند ممکن است در مقدار بازگشتی ، عددی کوچکتر از 1000 و بزرگتر از 50 قرار گیرد ، در این صورت مقدار بازگشتی متد یک کد خطا می باشد و باید با توجه به جدول ذیل خطای موجود را پیدا کرده و در صورت امکان مشکل موجود را برطرف نمایید .
توجه : خود کد 50 به معنی موفقیت آمیز بودن عملیات ( Successful ) می باشد و این مقدار فقط در مقدار بازگشتی از متد InsertNumberInNumberGroup قرار می گیرد .
کد خطا | توضیحات |
---|---|
51 | نام کاربری یا رمز عبور اشتباه است |
52 | نام کاربری یا رمز عبور خالی است |
60 | در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید |
63 | این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید ) |
70 | کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید ) |
74 | طول کلید NumberGroupID بیش از حد مجاز است ( بیش از 1000 عدد است ) |
75 | کلید NumberGroupID خالی است |
76 | کلید NumberGroupID نامعتبر است ( مقدار آن Null است ) |
77 | شما کاربر وب سرویس نیستید |
78 | شما کاربر سامانه مدیریت ارسال و دریافت پیام کوتاه نیستید |
79 | طول کلید PersonName با طول PersonNumber برابر نیست |
80 | در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید ) |
81 | طول کلید PersonNumber بیش از حد مجاز است ( بیش از 1000 عدد است ) |
82 | کلید PersonNumber خالی است |
83 | کلید PersonNumber نامعتبر است ( مقدار آن Null است ) |
84 | شماره گروه دفتر تلفن (NumberGroupID ) نامعتبر است ( وجود ندارد یا توسط کاربر حذف شده است ) |
205 | فرمت شماره PersonNumber اشتباه است |
207 | عنوان انگلیسی گروه دفتر تلفن نامعتبر است |
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 InsertNumberInNumberGroup($UserName, $Password, $NumberGroupID, $PersonNumber, $PersonName) { $person = ""; $number = ""; foreach ($PersonNumber as $item) { $number = $number . $item . ","; } foreach ($PersonName as $item) { $person = $person . $item . ","; } return $this->get_data("service=InsertNumberInNumberGroup&UserName=" . urlencode($UserName) . "&Password=" . urlencode($Password) . "&NumberGroupID=" . urlencode($NumberGroupID) . "&PersonNumber=" . urlencode(rtrim($number,",")) . "&PersonName=" . urlencode(rtrim($person,","))); } }
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[] InsertNumberInNumberGroup(String UserName, String Password, long NumberGroupID, String[] PersonNumber, String[] PersonName) throws Exception { String person = "", number = ""; for (String string : PersonNumber) { number += string + ","; } for (String string : PersonName) { person += string + ","; } String result = getUrl("service=InsertNumberInNumberGroup&UserName=" + encode(UserName) + "&Password=" + encode(Password) + "&NumberGroupID=" + encode(NumberGroupID) + "&PersonNumber=" + encode(rtrim(number)) + "&PersonName=" + encode(rtrim(person))); return toArrayOfLong(result); } }
public static class API { const string URL = "https://sms.sunwaysms.com/smsws/HttpService.ashx?"; /// <summary> /// Insert Number To PhoneBook /// </summary> /// <param name="UserName">String</param> /// <param name="Password">String</param> /// <param name="NumberGroupID">long GroupID</param> /// <param name="PersonNumber">Array of String </param> /// <param name="PersonName">Array of String </param> /// <returns>Array of long </returns> public static long[] InsertNumberInNumberGroup(string UserName, string Password, long NumberGroupID, string[] PersonNumber, string[] PersonName) { string person = "", number = ""; foreach (var item in PersonNumber) { number += item + ","; } foreach (var item in PersonName) { person += item + ","; } WebRequest request = WebRequest.Create(URL + "service=InsertNumberInNumberGroup&UserName=" + UserName + "&Password=" + Password + "&NumberGroupID=" + NumberGroupID + "&PersonNumber=" + number.TrimEnd(',') + "&PersonName=" + person.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> ''' Insert Number To PhoneBook ''' </summary> ''' <param name="UserName">String</param> ''' <param name="Password">String</param> ''' <param name="NumberGroupID">long GroupID</param> ''' <param name="PersonNumber">Array of String </param> ''' <param name="PersonName">Array of String </param> ''' <returns>Array of long </returns> Public Shared Function InsertNumberInNumberGroup(UserName As String, Password As String, NumberGroupID As Long, PersonNumber As String(), PersonName As String()) As Long() Dim person As String = "", number As String = "" For Each item As String In PersonNumber number += item & "," Next For Each item As String In PersonName person += item & "," Next Dim request As WebRequest = WebRequest.Create(URL & "service=InsertNumberInNumberGroup&UserName=" & UserName & "&Password=" & Password & "&NumberGroupID=" & NumberGroupID & "&PersonNumber=" & number.TrimEnd(","c) & "&PersonName=" & person.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
خیلی زود با شما تماس خواهیم گرفت
از طریق تلفن و واتساپ هم میتوانید با ما تماس بگیرید
در کمتر از یک دقیقه یک سامانه پیامک و وبسرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید