روش استفاده

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

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

وارد پنل کاربری سامانه پیشرو پیامک شوید. در بخش برنامه نویسان، توکن امنیتی، گزینه ساخت توکن جدید را پیدا کرده و روی آن کلیک کنید. سیستم به شما یک توکن یکتا و طولانی نمایش می‌دهد که باید آن را کپی کرده و در مکانی امن ذخیره کنید. این توکن در واقع کلید دسترسی شما به وب‌سرویس است و برای تمام درخواست‌های بعدی مورد استفاده قرار می‌گیرد.

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

اگر تاکنون گو را روی سیستم خود نصب نکرده‌اید، ابتدا آخرین نسخه آن را از وب‌سایت رسمی golang.org دانلود و نصب کنید. پس از نصب، با اجرای دستور go version در ترمینال از صحت نصب اطمینان حاصل کنید. برای این پروژه به کتابخانه‌های جانبی خاصی نیاز نیست و تمام امکانات مورد نیاز در کتابخانه استاندارد گو موجود است.

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

یک پوشه جدید برای پروژه خود ایجاد کنید (مثلاً sms_project). در داخل این پوشه، یک فایل با نام main.go ایجاد کنید. این فایل نقطه شروع برنامه شما خواهد بود. تمام کدهای مورد نیاز برای ارسال پیامک را در این فایل قرار دهید. ساختار کد به گونه‌ای است که یک ساختار (struct) برای سرویس پیامک تعریف شده و متدهایی برای ارسال درخواست به سرور و پردازش پاسخ در نظر گرفته شده است.

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

در کد خود، توکن دریافتی از مرحله اول را در متغیر مربوطه قرار دهید. همچنین شماره خط اختصاصی خود (فرستنده) را که در سامانه ثبت کرده‌اید، مشخص کنید. لیست شماره موبایل گیرندگان را به صورت یک اسلایس (آرایه) از رشته‌ها تعریف کنید و متن پیام مورد نظر خود را بنویسید. در صورت نیاز، نوع پیام را نیز می‌توانید تنظیم کنید (۰ برای معمولی و ۱ برای فلش).

مرحله پنجم: ارسال درخواست به وب‌سرویس

با استفاده از کتابخانه استاندارد net/http، یک درخواست از نوع POST به آدرس API سرویس ارسال می‌کنید. توکن دریافتی را در هدر درخواست با کلید token قرار می‌دهید. بدنه درخواست شامل شماره فرستنده، لیست گیرندگان، متن پیام و نوع پیام است که به فرمت JSON تبدیل شده و ارسال می‌شود. برای اطمینان از عدم قطعی ارتباط، تایم‌اوت درخواست را روی ۳۰ ثانیه تنظیم کنید.

مرحله ششم: دریافت پاسخ و تفسیر نتیجه

پس از ارسال درخواست، سرور پاسخ را به صورت یک شیء JSON بازمی‌گرداند. با استفاده از کتابخانه encoding/json، پاسخ را تجزیه کرده و وضعیت آن را بررسی می‌کنید. اگر کلید status برابر با ۲۰۰ باشد و در بخش result یک id عددی بزرگتر از صفر وجود داشته باشد، عملیات با موفقیت انجام شده است و آن عدد، کد پیگیری شما خواهد بود. در غیر این صورت، کلید status مقدار خطا را نشان می‌دهد که می‌توانید بر اساس آن مشکل را شناسایی کنید.

مرحله هفتم: تست و عیب‌یابی

پیش از استفاده گسترده، حتماً سرویس را با یک یا دو شماره تست کنید. برنامه خود را با دستور go run main.go اجرا کرده و خروجی را مشاهده کنید. اگر خطایی رخ داد، موارد زیر را به ترتیب بررسی کنید:

• صحت توکن

• معتبر بودن شماره فرستنده (خط اختصاصی ثبت‌شده در پنل)

• فرمت صحیح شماره‌های گیرندگان

• وجود اعتبار کافی در حساب کاربری برای ارسال پیامک

• اتصال اینترنت و عدم محدودیت دسترسی به آدرس API

• بررسی لاگ‌ها و پیام‌های خطای بازگردانده شده توسط سرور

۳. نکات فنی و بهینه‌سازی

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

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

• مدیریت خطاهای شبکه: در صورت بروز خطا در اتصال به سرور، برنامه خطای مربوطه را نمایش می‌دهد. بهتر است این خطاها را لاگ‌گیری کنید تا در صورت بروز مشکل، به راحتی عیب‌یابی انجام شود.

• پردازش پاسخ‌های JSON: ساختار پاسخ سرور به دقت در کد تعریف شده است. اگر پاسخ‌ها با ساختار متفاوتی بازگردانده شدند، می‌توانید ساختار SendSmsResponse را مطابق با مستندات سرویس به‌روزرسانی کنید