روش استفاده

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

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

مرحله دوم: ایجاد پروژه Dart/Flutter

• اگر از Flutter استفاده می‌کنید، یک پروژه جدید با flutter create ایجاد کنید.

• اگر از Dart به تنهایی استفاده می‌کنید، یک پروژه جدید با dart create ایجاد کنید.

مرحله سوم: اضافه کردن وابستگی http

فایل pubspec.yaml را باز کرده و کتابخانه http را به بخش dependencies اضافه کنید:

dependencies:
  http: ^1.1.0

سپس دستور pub get یا flutter pub get را اجرا کنید.

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

یک فایل جدید با نام sms_service.dart در پوشه lib (در Flutter) یا پوشه اصلی (در Dart) ایجاد کنید و کد بالا را در آن قرار دهید.

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

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

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

• برای Dart: دستور dart run را در ترمینال اجرا کنید.

• برای Flutter: برنامه را روی شبیه‌ساز یا دستگاه واقعی اجرا کنید.

در صورت موفقیت، کد پیگیری نمایش داده می‌شود.

۳. نکات فنی

• تایم‌اوت: به صورت پیش‌فرض، کتابخانه http تایم‌اوت مشخصی ندارد، اما می‌توانید با استفاده از timeout در Future آن را تنظیم کنید.

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

• مدیریت خطا: خطاهای شبکه، زمان‌بندی و JSON به درستی مدیریت می‌شوند.

• Async/Await: تمام عملیات به صورت غیرهمزمان انجام می‌شود تا رابط کاربری در Flutter قفل نشود.

• پلتفرم‌ها: این کد روی همه پلتفرم‌های تحت پشتیبانی Dart و Flutter (Android، iOS، Web، Windows، macOS، Linux) کار می‌کند.

۴. نکات امنیتی

• توکن را هرگز به صورت مستقیم و آشکار در کد قرار ندهید. از متغیرهای محیطی، فایل‌های .env یا flutter_dotenv برای ذخیره توکن استفاده کنید.

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

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

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

• برای Flutter، از flutter_secure_storage برای ذخیره امن توکن در دستگاه استفاده کنید.

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

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

• مدیریت دسترسی.

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

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