مشاهده وبسایت رایگان اس ام اس دریافت سامانه پیامک رایگان

وب سرویس ارسال و دریافت پیامک soap


 تاریخ : ۱۳۹۹/۲/۸ 19 Like

وب سرویس ارسال و دریافت پیامک soap

soap پروتکل دسترسی آسان به اشیاء و مخفف عبارت Simple Object Access Protocol می باشد، این پروتکل برای رد و بدل کردن اطلاعات بین برنامه ها استفاده می شود و بعنوان یکی از عمومی ترین استاندارد هایی است که در وب سرویس ها استفاده می شود، اطلاعات در SOAP به صورت پیام (Message) و از طریق پروتکل های موجود در اینترنت مانند HTTP منتقل می‏شود. به زبان ساده‏ تر، SOAP یک پروتکل برای دستیابی به یک سرویس ارایه شده در وب (Web Service) می باشد.

این بخش مربوط به برنامه نویسان بوده که با استفاده از امکان وب سرویس قصد ارسال و دریافت پیامک در نرم افزار کاربردی خود را دارند.با استفاده از این وب سرویس با امکانات فوق العاده قابلیت ارسال پیامک ، دریافت، زمانبندی بدون نیاز به سیستم و .... می باشد که توسط شرکت جهت سهولت کار کاربران در نظر گرفته شده است.لازم به ذکر است وب سرویس حاضر برای برنامه نویسان بصورت کاملا رایگان بوده و نیاز به هیچ هزینه ای نخواهد بود

 

1- دانلود راهنمای استفاده از وب سرویس ( SMS WebService /SMS API) ارسال و دریافت پیامک

2- دانلود نمونه کد ( Sample Source Code For SMS ) وب سرویس سامانه پیامک رایگان برای PHP

3- دانلود نمونه کد وب سرویس سامانه پیامک رایگان برای ASP .NET

شروع کار با وب سرویس

وب سرویس از یک سری متد تشکیل شده است که هر یک به منظوری خاص (ارسال پیامک ، دریافت پیامک ، دریافت وضعیت پیامک ، .....) طراحی شده است. برای استفده از وب سرویس کافی است یکی از متد های مورد نظر را انتخاب و پارامترهای مورد نظر را ست کنید.

نکته : خروجی هایی که در "" قرار می گیرند بدین معنا می باشند که مقدار بازگردانده شده از نوع string ‌می باشد.

افزودن متد ها به برنامه

برای فراخوانی متدهای وب سرویس ابتدا در قسمت Add Reference ادرس زیر را وارد کنید .

https://RayganSms.com/TrezSmsService.asmx

اکنون متد های وب سرویس به برنامه شما افزوده خواهد شد.که شامل متدهای زیر می باشد

  1. GetCredit
  2. GetMessageStatus
  3. GetReciveMessage
  4. SendCourseMessage
  5. SendMessage
  6. SendSchaduleMessage

معرفی متدها

1- متد SendMessage

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

نام متد

SendMessage

ورودی

نام پارامترها

نوع پارامترها

توضیح

Username

String

نام کاربری که در اختیار شما قرار گرفته است

Password

String

رمز عبوری که در اختیار شما قرار گرفته است

SenderNumber

String

شماره فرستنده مثال : 9830006859123456

MessageBody

String

متن پیامک

ReciptionNumbers

Long[]

شماره موبایل های مقصد

Class

int

نوع پیام (معمولی و یا خبری) *

UserMessageId

Long[]

شناسه پیامک کاربر (اختیاری)

خروجی

نوع پارامتر

توضیح

Long[]

آرایه ای از شناسه پیامک

 

* پارامتر Class

با تنظیم این پارامتر می توانید نوع پیام و نحوه نمایش پیامک ارسالی بر روی گوشی گیرنده را تنظیم نمایید

* پیامک خبری : اگر مقدار این پارامتر را 0 (صفر) قرار دهید این پیام در گوشی و سیم کارت شخص گیرنده بصورت اتوماتیک ذخیره نمی شود.

*پیامک عادی : اگر مقدار این پارامتر را 1 (یک) قرار دهید این پیام در گوشی و سیم کارت شخص گیرنده بصورت اتوماتیک ذخیره می شود..

برای مشخص کردن خروجی اولین مقدار آرایه را گرفته و بررسی نمایید.

مثال : long result = MessageId[0];

مقدار خروجی متد بصورت زیر می باشد:

Result > 1000 : ارسال بدون خطا 0 ، 3 : خطا در ارسال 2 : ارسال موفق بدون ذخیره پیام در سایت 4 : اعتبار ناکافی 5 : بیش از 4 پیام (طول پیام از مجاز بیشتر است) 6 : اطلاعات کاربری شما دستکاری شده است 7 : تعداد پیام (گیرندگان) بیش از حد مجاز می باشد 8 : اطلاعات کاربری نادرست می باشد.

2- متد GetReciveMessage :

Anchorاین متد برای دریافت پیامک می باشد .پارامترهای مورد نیاز این متد در جدول زیر آورده شده است. مقدار بازگشتی این متد یک رشته (string) می باشد که به منظور دریافت پیامکی که برای شماره اختصاصی شما ارسال شده است مورد استفاده قرار می گیرد

نکته : این رشته ممکن است شامل چند پیامک دریافتی باشد.

 

نام متد

GetReciveMessage

ورودی

نام پارامترها

نوع پارامترها

توضیح

Username

String

نام کاربری که در اختیار شما قرار گرفته است

Password

String

رمز عبوری که در اختیار شما قرار گرفته است

SenderNumber

String

شماره فرستنده مثال : 9830006859123456

خروجی

نوع پارامتر

توضیح

String

رشته ای از پیام های دریافتی

 

خروجی متد GetReciveMessage می تواند یکی از حالت های زیر باشد

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

در صورتی که یکی از حالتها بالا نباشد / مطابق مثال زیر می باشد

MessageBody-From-To- ReciveDate$MessageBody-From-To-rec.ReciveDate$

نمونه بالا شامل 2 پیام دریافتی می باشد که با $ از هم تفکیک می شوند. و هر پیام شامل: متن پیام ، فرستنده ، گیرنده ، زمان دریافت پیامک می باشد که با – از هم تفکیک می شوند.

3- متد GetCredit :

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

نام متد

GetCredit

ورودی

نام پارامترها

نوع پارامترها

توضیح

Username

String

نام کاربری که در اختیار شما قرار گرفته است

Password

String

رمز عبوری که در اختیار شما قرار گرفته است

SenderNumber

String

شماره فرستنده مثال : 9830006859123456

خروجی

نوع پارامتر

توضیح

Long

مقدار موجودی حساب

 

مثال

 

com.raygansms.TrezSmsWebService getcredit = new TabStripApp.com.raygansms.TrezSmsWebService();

long credit = getcredit.GetCredit(UserName, PassWord, Number);

 

4- متد GetMessageStatus :

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

نام متد

GetMessageStatus

ورودی

نام پارامترها

نوع پارامترها

توضیح

Username

String

نام کاربری که در اختیار شما قرار گرفته است

Password

String

رمز عبوری که در اختیار شما قرار گرفته است

SenderNumber

String

شماره فرستنده مثال : 9830006859123456

MessageId

Long[]

شناسه پیامک های ارسالی که هنگام ارسال دریافت شد.

خروجی

نوع پارامتر

توضیح

Int[]

آرایه ای از وضعیت پیام ها

مقدار خروجی متد بصورت زیر می باشد

· 1 : رسیده به گوشی

· 2 : نرسیده به گوشی

· 8 : رسیده به مخابرات

· 16 : نرسیده به مخابرات

· 0 : وضعیتی دریافت نشد

27 : ارسال پیامک تبلیغاتی برای این شماره امکان پذیر نمی باشد.

· -1 : شناسه ارسال شده اشتباه است

5- متد SendSchaduleMessage :

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

نام متد

SendSchaduleMessage

ورودی

نام پارامترها نوع پارامترها توضیح

Username

String

نام کاربری که در اختیار شما قرار گرفته است

Password

String

رمز عبوری که در اختیار شما قرار گرفته است

SenderNumber

String

شماره فرستنده مثال : 9830006859123456

MessageBody

String

متن پیامک

ReciptionNumbers

Long[]

شماره موبایل های مقصد

SendDate

DateTime

زمان ارسال پیامک

Class

int

نوع پیام (معمولی و یا خبری)

خروجی

نوع پارامتر

توضیح

string

رشته ای به عنوان نتیجه ارسال پیامک زما نبندی

 

مقدار خروجی متد بصورت زیر می باشد

  1. ارسال بدون خطا
  2. ارسال بدون خطا بدون ذخیره شدن در سایت
  3. خطای کلی
  4. اعتبار ناکافی
  5. بیش از 4 پیام (طول پیام از مجاز بیشتر است)
  6. اطلاعات کاربری شما دستکاری شده است
  7. تعداد پیام (گیرندگان) بیش از حد مجاز می باشد
  8. اطلاعات کاربری نادرست می باشد

 

6- متد SendCourseMessage :

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

نام متد

SendCourseMessage

ورودی

نام پارامترها نوع پارامترها توضیح
Username

String

نام کاربری که در اختیار شما قرار گرفته است
Password String رمز عبوری که در اختیار شما قرار گرفته است
SenderNumber String شماره فرستنده مثال : 9830006859123456
Topic String عنوان پیامک
MessageBody String متن پیامک
ReciptionNumbers Long[] شماره موبایل های مقصد
StartDate DateTime تاریخ شروع ارسال پیامک دوره ای
EndDate DateTime تاریخ پایان ارسال پیامک دوره ای
Period Int فاصله زمانی ارسال پیامک
Class int نوع پیام (معمولی و یا خبری)

خروجی

نوع پارامتر

توضیح

string

رشته ای به عنوان نتیجه ارسال پیامک زما نبندی

 

مقدار خروجی متد بصورت زیر می باشد

  1. ارسال بدون خطا
  2. ارسال بدون خطا بدون ذخیره شدن در سایت
  3. خطای کلی
  4. اعتبار ناکافی
  5. بیش از 4 پیام (طول پیام از مجاز بیشتر است)
  6. اطلاعات کاربری شما دستکاری شده است
  7. تعداد پیام (گیرندگان) بیش از حد مجاز می باشد
  8. اطلاعات کاربری نادرست می باشد.

 

مشاوره شما افتخار❤️ماست

ثبت نام رایگان در سامانه پیامک رایگان اس ام اس

برای کسب اطلاعات بیشتر می توانید به شماره های 01132290134 و یا 09116665601 تماس حاصل نمایید.



Like 19

در باره نویسنده
ابوالفضل برزگران
کارشناس نرم افزار(وب مستر-ایده پرداز) علاقه مند به حوزه ی سئو

ارسال نظر:



سوال :  2  + 8  = 

نام کاربری :  
       
رمز عبور :  


 
نام :  
       
ایمیل :    


   

جستجو
 

خرید پنل اس ام اس (رایگان) در چند لحظه و دریافت سامانه پیامک با امکانات کامل و نامحدود پنل اس ام اس
سایر خدمات ما
طراحی سایت
طراحی و تولید نرم افزار
نرم افزار جامع دهیاری
جستجوگر هوشمند خبر
رایگان اس ام اس
پنل اس ام اس تعرفه پیامک نمایندگی
ثبت نام رایگان شماره اختصاصی ورود به سامانه
سامانه پیام کوتاه وب سرویس پیامک انتقال پیامک
سوالات متداول امکانات سامانه پیامک تماس با ما
وب سرویس ارسال پیامک ویژه برنامه نویسان پلاگین وردپرس ارسال پیامک
ارسال پیامک از طریق url- وب سرویس ارسال پیامک rest انتقال پیامک های دریافتی به سایت شما
تماس با ما
آدرس : مازندران، بابل، خیابان نواب صفوی، روبروی اشرفی 16
تلفن : 01132290134
فکس : 02189774876
ایمیل : info [a] raygansms.com
پیامک : 30006859
تلگرام : @RayganSMS