ملی پیامک مستندات وب‌سرویس پیامک
ملی پیامک مستندات وب‌سرویس پیامک
ملی پیامک مستندات وب‌سرویس پیامک

ارسال پیامک با پورت خاص

آخرین به روز رسانی: 9 دی 1404

متد SendSms

این متد جهت ارسال پیامک پیشرفته(با پورت خاص) به یک یا چند گیرنده استفاده می‌شود. توجه کنید که محدودیت 100 عددی در هر بستۀ ارسال دارید.

پارامتر های ورودی

نام پارامترنوع پارامترتوضیحات
username String نام کاربری مربوط به حساب شما در سامانه
password String APIKey مربوط به حساب شما در سامانه
to String[] شماره‌های گیرنده، (حدأکثر 100 شماره موبایل در هر بار فراخوانی وارد کنید)
from String سرشمارۀ فرستندۀ اختصاصی
text String متن پیامک (متن اس ام اس را به‌همراه عبارت «لغو11» وارد کنید)
isflash Boolean متن پیامک به‌صورت flash ارسال گردد
udh String سرآمد پیامک (برای ارسال پیامک روی یک پورت خاص)
recId Ref Long[] هر خانۀ آرایه، یک کد یکتا به‌ازای هر گیرنده تولید می‌کند، این کد یکتا برای دریافت delivery کاربرد دارد
status Ref Byte[] هر خانۀ آرایه یک 0 یا 1 بوده که به‌ازای هر گیرنده تولید می‌شود و نشان‌گر این است که پیامک به این گیرنده موفق ارسال شده یا خیر (0 به معنی «ارسال شده» و 1 به معنی «ارسال نشده»)

مقدار بازگشتی

نام پارامترنوع پارامترتوضیحات
ReturnValue Int یک عدد : RecId ارسال
110- : استفاده از ApiKey به‌جای رمز عبور الزامی است.
109- : تنظیم آی‌پی IP مجاز برای استفاده از API الزامی است.
108- : به‌دلیل تلاش ناموفق برای استفاده از API، آی‌پی IP شما مسدود شده است. با پشتیبانی سامانه تماس بگیرید.
0 : نام کاربری یا APIKey اشتباه است.
1 : درخواست ارسال پیامک پیشرفته با موفقیت انجام شد.
2 : اعتبار پنل پیامکی برای این درخواست کافی نیست.
3 : در تعداد درخواست‌های ارسال، محدودیت روزانه دارید. لطفاً با پشتیبانی سامانه تماس بگیرید.
4 : در حجم هربار ارسال پیامک پیشرفته، محدودیت دارید. لطفاً با پشتیبانی سامانه تماس بگیرید.
5 : سرشمارۀ فرستنده معتبر نیست.
6 : سامانه درحال به‌روزرسانی است. لطفاً لحظاتی دیگر مجدداً تلاش کنید.
7 : متن پیامک شما حاوی کلمه یا کلمات فیلترشده است. لطفاً با پشتیبانی سامانه تماس بگیرید.
9 : ارسال پیامک از خطوط عمومی سامانه از طریق وب سرویس، امکان‌پذیر نیست.
10 : پنل پیامکی کاربر موردنظر فعال نیست.
11 : درخواست شما در وضعیت «ارسال نشده» قرار دارد.
12 : مدارک پنل پیامکی کاربر کامل نیست. لطفاً ابتدا پروسۀ احراز هویت پنل پیامک را تکمیل کنید.
14 : متن پیامک حاوی لینک است. لطفاً برای رفع محدودیت ارسال لینک با پشتیبانی سامانه تماس بگیرید.
15 : عبارت «لغو11» در انتهای متن پیامک وجود ندارد. (طبق قوانین سازمان تنظیم مقررات و ارتباطات رادیویی، درج عبارت «لغو11» در انتهای متن اس ام اس، الزامی است.)
18 : شماره موبایل گیرنده نامعتبر است. (لطفاً پارامتر to را بررسی کنید.)
SendSms
//GitHub نمونه کدهای
$username = 'username';
$password = 'password';
$api = new MelipayamakApi($username,$password);
$sms = $api->sms('soap');
$sms->send2($to,$from,$text,$isflash,$udh);

//بدون نیاز به پکیج گیت هاب Procedural PHP نمونه کدهای 
ini_set("soap.wsdl_cache_enabled",0);
$sms = new SoapClient("https://api.payamak-panel.com/post/send.asmx?wsdl",array("encoding"=>"UTF-8"));
$data = [
    "username" => "",
    "password" => "",
    "to" => array("",""),
    "from" => "",
    "text" => "تست",
    "isflash" => false,
    "udh"=> "",
    "recId" => array(0),
    "status" => 0x0
];
$result = $sms->SendSms($data);
var_dump($result->recId);
const username = 'username';
const password = 'password';
const api = new MelipayamakApi(username,password);
const sms = api.sms('soap');
sms.send2(to,from,text,isflash,udh);
final String username = "username";
final String password = "password";
SoapClient soapClient = new SoapClient(username, password);
soapClient.SendSms(to[], from, text, isflash, udh, recId[], status[]);
const string username = "username";
const string password = "password";
SendSoapClient soapClient = new SendSoapClient();
soapClient.SendSms(username, password, to[], from, text, isflash, udh, recId[], status[]);
Const  username As String = "username"
Const  password As String = "password"
Dim soapClient As New SendSoapClient()
soapClient.SendSms(username, password, toNums[], from, text, isflash, udh, recId[], status[])
let username: String = "username"
let password: String = "password"
var soapClient = SoapClient(user: username, pass: password)
soapClient.SendSms(arrayOfTo: [to1, to2], from: from, msg: text, isFlash: isflash, uhd: udh, arrayOfRecId: [id1, id2], arrayOfStatus: [st1, st2])
NSString *username = @"username";
NSString *password = @"password";
SoapClient *soapClient = [[SoapClient alloc] initCred:username password:password];
[soapClient SendSms:arrayOfTo from:from msg:text flash:isFlash uhd:uhd arrayOfRecId:array arrayOfStatus:stArray];
username = 'username'
password = 'password'
api = Api(username,password)
sms = api.sms('soap')
sms.send2(to,from,text,is_flash,udh)
final String username = "username";
final String password = "password";
SoapClient soapClient = new SoapClient(username, password);
soapClient.SendSms(to[], from, text, isflash, udh, recId[], status[]);
username = 'username'
password = 'password'
api = Melipayamakapi.new(username,password)
sms = api.sms('soap')
sms.send2(to,from,text,is_flash,udh)
my $username = "username";
my $password = "password";
my $soapClient = new SoapClient($username, $password);
$soapClient->SendSms(@to, $from, $text, $isflash, $udh, @recId, @status);
local username = "username";
local password = "password";
SendSms(username, password, to, from, text, isflash, udh, recId, status);
username := "username";
password := "password";
SendSms(username, password, to []string, from, text, isflash, udh, recId []string, status []string);
val username = "username"
val password = "password"
val soapClient = SoapClient(username, password)
soapClient.SendSms(arrayOf(to), from, text, isflash, udh, arrayOf(recId), arrayOf(status))
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SendSmsResponse xmlns="http://tempuri.org/">
      <SendSmsResult>int</SendSmsResult>
      <recId>
        <long>long</long>
        <long>long</long>
      </recId>
      <status>base64Binary</status>
    </SendSmsResponse>
  </soap:Body>
</soap:Envelope>