وب سرویس ارسال و دریافت پیامک 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) و در صورت بروز خطا کد خطا در خروجی قرار می گیرد.

* پارامتر Class

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

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

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

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

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

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

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

2- متد GetReciveMessage :

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

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

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

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

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

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

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

3- متد GetCredit :

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

مثال

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

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

4- متد GetMessageStatus :

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

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

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

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

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

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

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

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

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

5- متد SendSchaduleMessage :

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

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

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

6- متد SendCourseMessage :

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

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

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

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