روش استفاده

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

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

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

یک پروژه جدید در Xcode ایجاد کنید (می‌تواند از نوع iOS App یا macOS Command Line Tool باشد).

مرحله سوم: اضافه کردن کد

فایل SmsService.swift را به پروژه اضافه کرده و کد بالا را در آن قرار دهید.

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

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

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

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

۱. نکات فنی

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

• نوع پیام: type=0 برای معمولی و type=1 برای فلش.

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

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

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

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

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

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

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

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

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

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

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

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

۴. نام فایل

نام فایل را SmsService.swift بگذارید (با حرف S بزرگ).