روش استفاده

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

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

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

برای اجرای کد، نیاز به نصب کتابخانه‌های dkjson و luasec دارید. با استفاده از luarocks آنها را نصب کنید:

luarocks install dkjson
luarocks install luasec

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

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

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

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

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

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

lua SmsService.lua

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

۱. نکات فنی

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

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

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

• پردازش JSON: با استفاده از کتابخانه dkjson برای ساخت درخواست و پردازش پاسخ استفاده شده است.

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

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

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

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

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

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

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

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

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