روش استفاده

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

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

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

• اگر برای اندروید هستید، یک پروژه جدید در Android Studio ایجاد کنید.

• اگر برای JVM هستید، یک پروژه Gradle یا Maven ایجاد کنید.

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

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

dependencies {
    implementation("com.squareup.okhttp3:okhttp:4.12.0")
    implementation("org.json:json:20240303")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
}

سپس پروژه را همگام‌سازی (Sync) کنید.

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

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

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

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

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

• برای Android: برنامه را روی شبیه‌ساز یا دستگاه واقعی اجرا کنید.

• برای JVM: از run در IDE یا gradle run استفاده کنید.

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

۱. نکات فنی

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

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

• مدیریت خطا: از sealed class برای بازگرداندن نتیجه (موفقیت یا خطا) استفاده شده است.

• Suspend Function: تابع sendSms به صورت suspend طراحی شده تا با Coroutines کار کند.

• پردازش JSON: با استفاده از JSONObject (کتابخانه org.json) پاسخ پردازش می‌شود.

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

• توکن را هرگز به صورت مستقیم در کد قرار ندهید. از متغیرهای محیطی، فایل gradle.properties یا BuildConfig در اندروید استفاده کنید.

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

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

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

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

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

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

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

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