روش استفاده

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

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

مرحله دوم: نصب کتابخانه‌های مورد نیاز

برای کامپایل و اجرای کد، نیاز به نصب کتابخانه‌های libcurl و nlohmann/json دارید.

در اوبونتو/دبیان:

sudo apt-get install libcurl4-openssl-dev

برای nlohmann/json، می‌توانید از طریق apt یا به صورت هدر فقط استفاده کنید:

sudo apt-get install nlohmann-json3-dev

در سنت‌اواس/فدورا:

sudo yum install libcurl-devel

و nlohmann/json را از مخزن مربوطه یا به صورت دستی نصب کنید.

در مک‌اواس (با Homebrew):

brew install curl nlohmann-json

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

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

مرحله چهارم: کامپایل

کد را با استفاده از کامپایلر C++ (مانند g++) کامپایل کنید:

g++ -std=c++11 -o sms SmsService.cpp -lcurl

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

برنامه را اجرا کنید:

./sms

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

۱. نکات فنی

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

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

• مدیریت خطا: خطاها با استفاده از کدهای بازگشتی CURL و مدیریت استثناها مدیریت می‌شوند.

• پردازش JSON: با استفاده از کتابخانه nlohmann/json برای ساخت درخواست و پردازش پاسخ استفاده شده است.

• مدیریت حافظه: تمام منابع به درستی آزاد می‌شوند.

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

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

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

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

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

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

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

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

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

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