روش استفاده

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

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

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

یک پروژه جدید با استفاده از sbt (Scala Build Tool) ایجاد کنید:

sbt new scala/scala-seed.g8
cd your-project

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

فایل build.sbt را باز کرده و وابستگی‌های زیر را اضافه کنید:

libraryDependencies ++= Seq(
  "com.softwaremill.sttp.client3" %% "core" % "3.9.0",
  "com.softwaremill.sttp.client3" %% "httpclient-backend" % "3.9.0",
  "io.circe" %% "circe-core" % "0.14.5",
  "io.circe" %% "circe-generic" % "0.14.5",
  "io.circe" %% "circe-parser" % "0.14.5"
)

سپس دستور sbt update را اجرا کنید.

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

یک فایل جدید با نام SmsService.scala در پوشه src/main/scala ایجاد کنید و کد بالا را در آن قرار دهید.

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

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

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

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

sbt run

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

۱. نکات فنی

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

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

• مدیریت خطا: با استفاده از Try و Either در Scala مدیریت شده است.

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

• هم‌روندی: درخواست‌ها با استفاده از Future به صورت غیرهمزمان ارسال می‌شوند.

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

• توکن را هرگز به صورت مستقیم در کد قرار ندهید. از متغیرهای محیطی (sys.env.getOrElse("TOKEN", "")) یا فایل‌های پیکربندی استفاده کنید.

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

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

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

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

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

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

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

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