روش استفاده

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

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

مرحله دوم: ایجاد پروژه Rust

یک پروژه جدید با استفاده از Cargo ایجاد کنید:

cargo new sms_project

cd sms_project

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

فایل Cargo.toml را باز کرده و وابستگی‌های زیر را به بخش [dependencies] اضافه کنید:

[dependencies]
reqwest = { version = "0.11", features = ["json"] }
serde_json = "1.0"
tokio = { version = "1", features = ["full"] }

سپس دستور cargo build را اجرا کنید تا وابستگی‌ها نصب شوند.

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

فایل src/main.rs را باز کرده و کد بالا را در آن قرار دهید. یا اگر می‌خواهید کد را در فایل جداگانه قرار دهید، یک فایل src/sms_service.rs ایجاد کرده و کد را در آن قرار دهید و سپس در main.rs از آن استفاده کنید.

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

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

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

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

cargo run

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

۱. نکات فنی

• تایم‌اوت: به صورت پیش‌فرض روی ۳۰ ثانیه تنظیم شده است. در صورت نیاز می‌توانید مقدار Duration::from_secs() را تغییر دهید.

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

• مدیریت خطا: به سبک Rust از Result و Option برای مدیریت خطاها استفاده شده است.

• Async/Await: از فریم‌ورک tokio برای اجرای کدهای غیرهمزمان استفاده شده است.

• امنیت حافظه: Rust به صورت ذاتی از خطاهای حافظه مانند سرریز بافر جلوگیری می‌کند.

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

• توکن را هرگز به صورت مستقیم و آشکار در کدهای منبع قرار ندهید. از متغیرهای محیطی (std::env::var("TOKEN")) یا فایل‌های پیکربندی استفاده کنید.

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

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

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

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

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

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

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

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