وب سرویس

نسخه جدید API وب سرویس ویژه استفاده برنامه نویسان

این روش از روشهای پیشرفته در انتقال پیامک به شمار می رود . این متد، ارسال و دریافت پیامک های فارسی ، لاتین و باینری با اندازه های متفاوت را دارا می باشد . برای برقراری ارتباط با API   می توانید از دو پروتکل HTTP بر روی پورت 80 ، و یا استفاده از پروتکل امن HTTPS   بر روی پورت 443 استفاده نمایید. با استفاده از این امکان شما قادر خواهید بود در سایت و یا نرم افزار خود از طریق ارتباط با سرورهای پیام کوتاه، پیامک با تنظیمات دلخواه خود ارسال نمایید .

برخی از امکانات به کار رفته در نسخه جدید در زیر آمده است :

1-      ارسال پیامک تکی
2-      ارسال پیامک گروهی
3-      ارسال پیامک تکی در آینده
4-      ارسال پیامک گروهی در آینده
5-      ارسال اس ام اس به صورت منطقه ای از طریق کد پستی
6-      ارسال اس ام اس به شماره های فعال شهر و یا استان مورد نظر خود
7-      ارسال اس ام اس به شماره های فعال پیش شماره دلخواه
8-      دریافت پیامک به صورت تکی
9-      دریافت پیامک به صورت بازه ای
10-    دریافت پیامک های نخوانده شده
11-    آگاهی از تعداد پیام های دریافتی
12-    آگاه از تعداد پیام های ارسالی
13-    آگاهی از وضعیت پیام های ارسالی (Delivery)
14-    مشاهده وضعیت پیامک های ارسالی در آینده
15-    دریافت موجودی پنل پیام کوتاه

در نسخه جدید وب سرویس کلیه موارد جهت ارتباطی مناسب و سرعت ارسال و دریافت خوب رعایت شده است و همکاران گرامی نیز می توانند با استفاده از این امکان از تعرفه پیام کوتاه مناسب و سرعت بالا برخوردار شوند. جهت تست سرعت ارسال و امکانات قید شده بعد از ثبت نام در سایت با واحد فروش تماس حاصل نمایید تا این امکان را برای شما فعال نمایند . راهنمای کامل وب سرویس به همراه نمونه کد به زبان های مختلف در منوی دانلود ها آمده است.

برای ارسال پیامک از طریق متد GET روی Http  از آدرس زیر استفاده می شود :

http://epayamak.net/post/sendSMS.ashx

پارامتر ها  :

username : نام کاربری
password : رمز عبور
from : شماره پیامک فرستنده (مثلا 30001384)
to: شماره گیرنده ( مثلا 9351469928) همچنین میتوانید چند شماره رو هم با کاراکتر ; از هم جدا کنید (مثلا9351469928;9351469928)
text : متن پیامک

نمونه »
http://epayamak.net/post/sendSMS.ashx?from=10001234&to=912…&text=test&password=YourPass&username=YourUsername

کد های بازگشتی : 

0 نام کاربری یا رمز عبور صحیح نمی باشد

1 ارسال با موفقیت انجام شد

2 اعتبار کافی نیست

3 محدودیت در ارسال روزانه

4 محدودیت در حجم ارسال

5 شماره فرستنده معتبر نیست

7 کاراکتر استفاده شده فیلتر می باشد

همچنین میتوانید از وب سرویس WSDL نیز استفاده نمایید :

http://www.epayamak.net/post/send.asmx

نام متد : SendSms

پارامتر ها :

username : نام کاربری
password : رمز عبور
from : شماره پیامک فرستنده (مثلا 30001384)
to: آرایه ای از String که هر آرایه شماره گیرنده ( مثلا 9351469928)  است
text : متن پیامک
udh : سرآمد پیامک ( میتوانید خالی باقی بگذارید )
isFlash : تعیین می کند که پیامک فلش ارسال شود یا نه
recId : آرایه ای از Long است که به صورت Ref به متد داده شده و پس از ارسال آرایه پر خواهد شد ، هر خانه آرایه یک کد یکتا به اضای هر گیرنده تولید می کند ، این کد یکتا برای دریافت Delivery کاربر دارد
Status : آرایه ای از Byte است که به صورت Ref به متد داده شده و پس از ارسال آرایه پر خواهد شد ، هر خانه آرایه یک کد 0 یا 1 بوده که به  اضای هر گیرنده تولید می شود و نشانگر این است که پیامک به این گیرنده موفق ارسال شده یا نه ( 0 به معنی ارسال شده و 1 به معنی ارسال نشده است )

مقدار خروجی متد یک int بوده که معنی آن به شرح زیر است :

0 نام کاربری یا رمز عبور صحیح نمی باشد

1 ارسال با موفقیت انجام شد

2 اعتبار کافی نیست

3 محدودیت در ارسال روزانه

4 محدودیت در حجم ارسال

5 شماره فرستنده معتبر نیست

7 کاراکتر استفاده شده فیلتر می باشد

همچنین مثال استفاده از وب سرویس به زبان #C و VB.NET دانلود کنید.

نمونه کد برای نرم افزار تحت وب به زبان های #C وVB.NET