روش استفاده

مرحله اول: دریافت توکن

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

مرحله دوم: ایجاد فایل کلاس

یک فایل جدید با نام SmsService.m ایجاد کنید و کد بالا را در آن قرار دهید. توجه کنید که نام فایل باید دقیقاً با نام کلاس یکی باشد.

مرحله سوم: تنظیم توکن و پارامترها

در قسمت نمونه استفاده (پایین کد)، توکن دریافتی، شماره فرستنده، لیست گیرندگان و متن پیام را جایگزین کنید.

مرحله چهارم: اجرا

کد را در MATLAB (نرم‌افزار یا خط فرمان) اجرا کنید. در صورت موفقیت، کد پیگیری نمایش داده می‌شود.

۱. نکات فنی

• تایم‌اوت: به صورت پیش‌فرض ۳۰ ثانیه با استفاده از Timeout در weboptions تنظیم شده است.

• نوع پیام: پارامتر type با مقدار 0 برای پیامک معمولی و 1 برای پیامک فلش (نمایشی) استفاده می‌شود.

• مدیریت خطا: خطاها با استفاده از try-catch مدیریت می‌شوند و پیام خطا بازگردانده می‌شود.

• پردازش JSON: با استفاده از jsonencode برای ساخت درخواست و jsondecode (به صورت خودکار در webwrite) برای پردازش پاسخ استفاده شده است.

• ساختار کلاس: از کلاس‌های MATLAB با ارث‌بری از handle استفاده شده است.

۲. نکات امنیتی

• توکن را هرگز به صورت مستقیم در کد قرار ندهید. از متغیرهای محیطی یا فایل‌های پیکربندی خارج از دایرکتوری پروژه استفاده کنید.

• همیشه از پروتکل HTTPS برای ارتباط استفاده کنید.

• توکن را به صورت دوره‌ای تمدید کنید.

• در صورت پایان پروژه، توکن را از پنل کاربری باطل کنید.

۳. مزایای روش توکن

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

• قابلیت انقضا و مدیریت دسترسی.

• کاهش حجم درخواست‌ها و افزایش سرعت.

• سازگاری با معماری‌های مدرن.