2 رای ثبت شده
برای استفاده از وب سرویس SOAP کافی است این سرویس را از یکی از آدرسهای زیر فراخوانی کنید و با توجه به توضیحات متد از آن استفاده کنید:
| wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl |
| non-wsdl | http://sms.sunwaysms.com/SMSWS/SOAP.asmx |
آدرس وبسرویس
آدرس گیتهاب
| نام پارامتر | نوع | اجباری/اختیاری | توضیح |
|---|---|---|---|
| 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 (اجباری) دقیقه مورد نظر برای ارسال زمانبندی |
| نوع خروجی | توضیحات |
|---|---|
| Long Integer | شناسه ارسال زمانبندی شده یا کد خطا |
در تمام متدهایی که مقدار 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 | به علت کمبود اعتبار پیام کوتاه شما توانایی ارسال به این شماره را ندارید ( پس از شارژ حساب دوباره ارسال کنید ) |
| 206 | شماره اپراتور نامعتبر می باشد |
| 300 | ارسال پیامک حاوی لینک مجاز نمی باشد ( توافقنامه ارسال لینک امضا نشده است) |
| 400 | تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است. |
| 666 | سرویس موقتاً غیر فعال است |
| 777 | این IP مسدود است |
| 888 | برای شماره فرستنده احراز هویت ثبت نشده است |
| 999 | ارسال این پیامک مجاز نیست |
<?php
class SMS
{
public $Username = '';
public $Password = '';
private $SoapAddress = 'https://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl';
private $client;
function __construct()
{
$this->client = new SoapClient($this->SoapAddress);
}
public Function GetClient(){
return $this->client;
}
public Function GetClientEx($option){
return new SoapClient($this->SoapAddress, $option);
}
public Function GetMethods(){
$arr = array();
$client = GetClient();
return $client->__getFunctions();
}
public Function SendArraySchedule($MobileNumbersArray, $Message, $SpecialNumber, $IsFlashMessage, $CheckingMessageID, $Year, $Month, $Day, $Hour, $Minute){
$option = array('UserName'=> $this->Username,'Password'=> $this->Password,'RecipientNumber'=> $MobileNumbersArray,'MessageBody'=> $Message,'SpecialNumber'=> $SpecialNumber,'IsFlashMessage'=> $IsFlashMessage,'CheckingMessageID'=> $CheckingMessageID, 'Year'=> $Year, 'Month'=> $Month, 'Day'=> $Day, 'Hour'=> $Hour, 'Minute'=> $Minute);
$client = $this->GetClient();
return $client->SendArraySchedule($option)->SendArrayScheduleResult;
}
}
?> /**
Send Array Schedule
@param UserName String
@param Password String
@param RecipientNumber Send SMS to this numbers
@param Message Text of your SMS
@param SpecialNumber
@param IsFlash True/False
@param Year int
@param Month int
@param Day int
@param Hour int
@param Minute int
@return MessageID
*/
public final long SendArraySchedule(String UserName, String Password, String[] RecipientNumber, String Message, String SpecialNumber, boolean IsFlash, int Year, int Month, int Day, int Hour, int Minute)
{
try (SOAP.SMS SMSService = new SOAP.SMS())
{
return SMSService.SendArraySchedule(UserName, Password, RecipientNumber, Message, SpecialNumber, IsFlash, Year, Month, Day, Hour, Minute);
}
catch (RuntimeException ex){}
} public static class API {
///
/// Send Array Schedule
///
/// String
/// String
/// Send SMS to this numbers
/// Text of your SMS
///
/// True/False
/// int
/// int
/// int
/// int
/// int
///
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) {
using (SOAP.SMS SMSService = new SOAP.SMS()) {
return SMSService.SendArraySchedule(UserName, Password, RecipientNumber, Message, SpecialNumber, IsFlash,Year,Month,Day,Hour,Minute);
}
}
} Imports System.Net
Imports System.IO
Imports System.Text
Imports System.Web.Script.Serialization
public Class API
''' <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
Using SMSService As New SOAP.SMS()
Return SMSService.SendArraySchedule(UserName, Password, RecipientNumber, Message, SpecialNumber, IsFlash, _
Year, Month, Day, Hour, Minute)
End Using
End Function
End Class
خیلی زود با شما تماس خواهیم گرفت
از طریق تلفن و واتساپ هم میتوانید با ما تماس بگیرید
در کمتر از یک دقیقه یک سامانه پیامک و وبسرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید