روش استفاده

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

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

مرحله دوم: نصب کتابخانه‌های مورد نیاز

برای اجرای کد، نیاز به نصب دو کتابخانه اصلی دارید. در کنسول R یا RStudio، دستورات زیر را اجرا کنید:

install.packages("httr")

install.packages("jsonlite")

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

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

مرحله چهارم: بارگذاری و استفاده

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

مرحله پنجم: اجرا

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

۱. نکات فنی

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

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

• مدیریت خطا: تابع یک لیست با سه عضو success، id و error بازمی‌گرداند.

• پردازش JSON: با استفاده از toJSON برای ساخت درخواست و fromJSON برای پردازش پاسخ استفاده شده است.

• ساختار کلاس: از یک لیست ساده به عنوان کلاس استفاده شده است (روش S3 در R).

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

• توکن را هرگز به صورت مستقیم در کد قرار ندهید. از متغیرهای محیطی (Sys.getenv("TOKEN")) یا فایل‌های پیکربندی خارج از دایرکتوری عمومی استفاده کنید.

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

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

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

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

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

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

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

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