Blog

وب سرویس ارسال و دریافت پیامک ترز ( ویژه برنامه نویسان )

وب سرویس ارسال و دریافت پیامک ترز ( ویژه برنامه نویسان )

( SMS WebService /SMS API)

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

با استفاده از این وب سرویس با امکانات فوق العاده قابلیت ارسال پیامک ، دریافت، زمانبندی بدون نیاز به سیستم  و …. می باشد که توسط شرکت جهت سهولت کار کاربران در نظر گرفته شده است.

لازم به ذکر است وب سرویس حاضر برای برنامه نویسان بصورت کاملا رایگان بوده و نیاز به هیچ هزینه ای نخواهد بود

در صورت نیاز به مشاوره در امور برنامه نویسی و وب سرویس می توانید با کارشناسان پشتیبانی شرکت در تماس باشید

تلفن تماس: ۰۱۱- ۳۲۲۹۰۱۳۴

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

۲- دانلود نمونه کد ( Sample Source Code For SMS ) وب سرویس سامانه پیامک برای ASP .NET

۳- دانلود نمونه کد برای PHP

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

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

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

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

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

http://Sms.trez.ir/TrezSmsService.asmx

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

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

معرفی متدها :

۱-    متد SendMessage  :

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

* پارامتر Class

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

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

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

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

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

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

• Result > 1000 : ارسال بدون خطا
•  ۰ ، ۳ : خطا در ارسال
• ۲ : ارسال موفق بدون ذخیره پیام در سایت
• ۴ : اعتبار ناکافی
• ۵ : بیش از ۴ پیام (طول پیام از مجاز بیشتر است)
• ۶ : اطلاعات کاربری شما دستکاری شده است
• ۷ : تعداد پیام (گیرندگان) بیش از حد مجاز می باشد
• ۸ : اطلاعات کاربری نادرست می باشد.

۲-   متد GetReciveMessage  :

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

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

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

“۱” : اطلاعات کاربری شما معتبر نمی باشد

“۲”: شما مجاز به دریافت پیامک نمی باشید برای تهیه نسخه دریافت کننده با شرکت ترزرایان افزار تماس حاصل نمایید . نسخه فقط ارسال

“۳”: پیام جدیدی وجود ندارد

در صورتی که یکی از حالتها بالا نباشد

مطابق مثال زیر می باشد

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

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

۳-  متد GetCredit  :

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

مثال :

ir.trez.sms.TrezSmsWebService getcredit = newir.trez.sms.TrezSmsWebService();

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

۴-  متد GetMessageStatus  :

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

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

• ۱ : رسیده به گوشی
• ۲ : نرسیده به گوشی
• ۸ : رسیده به مخابرات
• ۱۶ : نرسیده به مخابرات
• ۰ : وضعیتی دریافت نشد
• -۱ : شناسه ارسال شده اشتباه است

۵-  متد SendSchaduleMessage  :

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

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

• “۱” : ارسال بدون خطا
• “۲” : ارسال بدون خطا بدون ذخیره شدن در سایت
• “۳” : خطای کلی
• “۴” : اعتبار ناکافی
• “۵” : بیش از ۴ پیام (طول پیام از مجاز بیشتر است)
• “۶” : اطلاعات کاربری شما دستکاری شده است
• “۷” : تعداد پیام (گیرندگان) بیش از حد مجاز می باشد
• “۸” : اطلاعات کاربری نادرست می باشد.

۶-  متد SendCourseMessage  :

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

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

• “۱” : ارسال بدون خطا
• “۲” : ارسال بدون خطا بدون ذخیره شدن در سایت
• “۳” : خطای کلی
• “۴” : اعتبار ناکافی
• “۵” : بیش از ۴ پیام (طول پیام از مجاز بیشتر است)
• “۶” : اطلاعات کاربری شما دستکاری شده است
• “۷” : تعداد پیام (گیرندگان) بیش از حد مجاز می باشد
• “۸” : اطلاعات کاربری نادرست می باشد.

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

برای دریافت ازاطلاعات بیشتر و یا راهنمایی بابت ثبت نام می توانید با شماره ۰۱۱۳۲۲۹۰۱۳۴ تماس حاصل نمایید.