روش استفاده

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

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

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

• یک پروژه جدید ایجاد کنید.

• اگر از Node.js استفاده می‌کنید، دستورات زیر را اجرا کنید:

  text

  npm init -y
  npm install typescript @types/node --save-dev
  npx tsc --init

• اگر از فرانت‌اند (مثل React) استفاده می‌کنید، پروژه را با ابزار مناسب ایجاد کنید (مثل create-react-app --template typescript).

مرحله سوم: نصب وابستگی‌ها

کتابخانه axios را نصب کنید:

npm install axios

برای تایپ‌های TypeScript (در Node.js):

npm install @types/node --save-dev

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

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

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

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

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

• برای Node.js، فایل را کامپایل کرده و اجرا کنید:

  text

  npx tsc
  node dist/SmsService.js

• برای فرانت‌اند، برنامه را با دستور npm start یا مشابه آن اجرا کنید.

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

۱. نکات فنی

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

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

• تایپ‌های قوی: استفاده از interface برای درخواست، پاسخ و نتیجه، کد را امن‌تر و خواناتر می‌کند.

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

• Async/Await: تمام عملیات به صورت غیرهمزمان انجام می‌شود.

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

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

• در فرانت‌اند، توکن را در سمت سرور نگه دارید و از طریق API به فرانت‌اند ارسال کنید.

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

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

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

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

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

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

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

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