روش استفاده

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

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

مرحله دوم: نصب ماژول‌های مورد نیاز

برای اجرای کد، نیاز به نصب چند ماژول Perl دارید. در ترمینال دستورات زیر را اجرا کنید:

cpan install LWP::UserAgent
cpan install JSON
cpan install HTTP::Request
cpan install HTTP::Headers

اگر از سیستم‌عامل لینوکس استفاده می‌کنید، ممکن است این ماژول‌ها از قبل نصب باشند.

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

• فایل SmsService.pm را ایجاد کرده و کد کلاس را در آن قرار دهید.

• فایل test.pl (یا هر نام دلخواه دیگر) ایجاد کرده و کد نمونه استفاده را در آن قرار دهید.

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

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

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

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

perl test.pl

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

۱. نکات فنی

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

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

• مدیریت خطا: کد به صورت (success, id, error) سه مقدار بازمی‌گرداند.

• پردازش JSON: با استفاده از ماژول JSON، درخواست و پاسخ پردازش می‌شوند.

• امنیت SSL: در LWP::UserAgent، گزینه verify_hostname => 1 برای تأیید هویت سرور فعال است.

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

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

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

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

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

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

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

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

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

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