روش استفاده

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

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

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

یک فایل جدید با نام sms_service.rb ایجاد کنید و کد بالا را در آن قرار دهید.

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

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

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

در ترمینال، دستور زیر را اجرا کنید:

ruby sms_service.rb

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

۱. نکات فنی

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

• نوع پیام: type=0 برای پیامک معمولی و type=1 برای پیامک فلش (نمایشی).

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

• کتابخانه‌ها: از کتابخانه‌های استاندارد Ruby (net/http, uri, json) استفاده شده است و نیاز به نصب gem خاصی نیست.

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

• توکن را هرگز در کد به صورت مستقیم قرار ندهید. از متغیرهای محیطی (ENV['TOKEN']) استفاده کنید.

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

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

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

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

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

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

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

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