وب سرویس چه کاربردی دارد؟
این سرویس به برنامه نویسان این امکان را می دهد تا با کمترین
کد نویسی (در حد چند خط کد) در برنامه های خود قابلیت ارسال و دریافت پیامک را فراهم
کنند.
قابلیت های وب سرویس
1- ارسال پیامک فارسی و لاتین
اگر دانشی در زمینه
UDH
ندارید نگران نباشید ، با وب سرویس ما می توانید پیامک های فارسی و لاتین خود را ارسال نمایید. فقط کافیست متن را تایپ کنید!
2- تشخیص وضعیت دلیوری پیامک
یکی از متدهای API به شما این امکان را می دهد که بررسی کنید آیا SMS ارسالی به گوشی
مخاطب رسیده است و اگر نرسیده است وضعیت آن به چه صورت می باشد.
جای نگرانی نیست ! مشتریان شما می توانند به هر تعدادی به شماره شما پیام کوتاه ارسال
کنند ، چون ما برای دریافت SMS از شما هزینه ای نخواهیم گرفت.
4- سرعت فوق العاده
اگر زمانی نیاز داشتید که حجم زیادی پیام کوتاه ارسال کنید فقط کافیست از یک حلقه For
استفاده کنید! API می تواند بین 50 تا 200 هزار SMS در هر ساعت ارسال کند.
5- امکان استفاده در تمامی زبانهای برنامه نویسی
API را می توانید در تمام زبان های برنامه نویسی تحت وب یا تحت ویندوز از قبیل C# ،
PHP ، ASP ، جاوا ، دلفی ، VB.net و ... استفاده کنید. ما برنامه های نمونه ای در اختیار
شما قرار می دهیم تا با نحوه استفاده از API در زبان های برنامه نویسی C# ، VB.net
، ASP ، PHP و دلفی آشنا شوید.
6- قابلیت استفاده در چندین برنامه مختلف
از API می توانید در چندین سایت و یا برنامه تحت ویندوز بصورت همزمان استفاده کنید.
توجه:
در صورتی که سرعت و کیفیت ارسال برای شما اهمیت دارد، پیشنهاد ما استفاده از خطوط 3000 هست.
راهنمای استفاده از وب سرویس مبتنی بر پروتکل SOAP
مستندات و نمونه کدها را در این بخش می توانید دانلود نمایید.
نمونه کد
<?php
$username='XXXXXXXX';
$password='XXXXXX';
$sendNumber='XXXXXXXXXX';
$message='test';
$mobiles=array();
array_push($mobiles,'09XXXXXXXXX');
$client=new SoapClient("http://sapack.ir/services/smsService.svc?wsdl");
$params=array('username'=>$username,'password'=>$password,
'senderNumber'=>$sendNumber,'recipientNumbers'=>$mobiles,'message'=>$message,'saveType'=>1);
$result=$client->sendMessage($params);
?>
در ویژوال استودیو بر روی پروژه خود کلیک راست کنید و گزینه
Add Service Reference
را انتخاب نمایید. آدرس وب سرویس ساپک که در مستندات آمده را در بخش مربوطه وارد نمایید. ویژوال استودیو کدهای لازم را برای شما تولید می کند و با نمونه کد زیر می توانید از وب سرویس استفاده نمایید.
SmsServiceClient smsService = new SmsServiceClient();
string[] result = smsService.SendMessage("USERNAME", "PASS", "5000XXXX", new string[] {"09XXXXXXXXX", "09XXXXXXXXX"}, "TEST", 1);
import zeep
username = 'username'
password = 'password'
sendNumber = 'senderNumber'
message = "test"
mobiles = ["09XXXXXXXXX", "09XXXXXXXXX"]
params = {'username': username, 'password': password, 'senderNumber': sendNumber, 'recipientNumbers': mobiles,'message': message, 'saveType': 1}
url = "http://sapack.ir/services/smsService.svc?wsdl"
client = zeep.Client(wsdl=url)
client.service.SendMessage(**params)
راهنمای ارسال پیامک از طریق URL
برای ارسال پیامک از طریق
URL
به شکل زیر عمل نمایید:
http://api.sapak.me/sendmessage?user={USERNAME}&pass={PASSWORD}&from={SMS_NUMBER}&to={MOBILE}&text={MESSAGE}
دقت نمایید که پارامترهای ارسالی خصوصا در مورد کلمه عبور (در صورتی که حاوی کاراکترهای خاص باشد) باید به صورت کدگذاری شده ارسال شود.
همچنین علائم { و } صرفا برای نشان دادن قالب است و نباید نام کاربری و رمز عبور و سایر پارامترها داخل آن قرار بگیرد.
پس از ارسال از طریق
URL
خروجی با فرمت
JSON
به شما برگردانده می شود. برای آشنایی با کدهای برگشتی و همینطور کدهای خطا، به فایل راهنمای وب سرویس در همین صفحه مراجعه نمایید.