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
خیلی زود با شما تماس خواهیم گرفت
از طریق تلفن و واتساپ هم میتوانید با ما تماس بگیرید
در کمتر از یک دقیقه یک سامانه پیامک و وبسرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید