pishropayamak-sms 1.0.0

پکیج رسمی ارسال پیامک پیشرو پیامک برای پایتون

📱 پکیج رسمی پیشرو پیامک برای پایتون

پکیج رسمی پیشرو پیامک برای ارسال آسان پیامک در پروژه‌های پایتون.

✨ ویژگی‌ها

• ارسال پیامک با احراز هویت توکن
• ارسال گروهی به چندین گیرنده
• پشتیبانی از پیامک معمولی و فلش
• دریافت کد پیگیری
• مدیریت خطاهای حرفه‌ای
• تست شده و قابل اطمینان

📦 نصب

pip install pishropayamak-sms

🚀 استفاده
روش اول: استفاده از کلاس اصلی
python

from pishropayamak_sms import SmsService

sms_service = SmsService('your_token_here')

result = sms_service.send_sms(
    from_number='9444xxxxxx',
    recipients=['09121234567'],
    message='سلام! به پیشرو پیامک خوش آمدید.'
)

if result['success']:
    print(f"کد پیگیری: {result['id']}")
else:
    print(f"خطا: {result['error']}")

ارسال گروهی
python

result = sms_service.send_sms(
    from_number='9444xxxxxx',
    recipients=['09121234567', '09129876543', '09123456789'],
    message='تخفیف ویژه تا ۲۴ ساعت دیگر!'
)

ارسال پیام فلش
python

result = sms_service.send_sms(
    from_number='9444xxxxxx',
    recipients=['09121234567'],
    message='پیام فوری!',
    msg_type=1  # نوع فلش
)

📝 پارامترهای متد send_sms
پارامتر	نوع	ضروری	توضیح
from_number	str	بله	شماره فرستنده (خط اختصاصی)
recipients	List[str]	بله	لیست شماره گیرندگان
message	str	بله	متن پیامک
msg_type	int	خیر	0=معمولی، 1=فلش
🔧 مدیریت خطاها
python

from pishropayamak_sms import SmsService
from pishropayamak_sms.exceptions import (
    AuthenticationError,
    NetworkError,
    SendError,
    ValidationError
)

try:
    result = sms_service.send_sms(...)
except ValidationError as e:
    print(f"خطای اعتبارسنجی: {e}")
except AuthenticationError as e:
    print(f"خطای احراز هویت: {e}")
except NetworkError as e:
    print(f"خطای شبکه: {e}")
except SendError as e:
    print(f"خطای ارسال: {e}")

🔒 نکات امنیتی

    توکن را در کد قرار ندهید! از متغیرهای محیطی استفاده کنید.

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

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

🌐 وب‌سایت رسمی

https://pishropayamak.ir
🔗 مخزن گیت‌هاب

https://github.com/MohammadrezaRahpeyma/pishropayamak-python-sms
📄 مجوز

این پکیج تحت مجوز MIT منتشر شده است.

ساخته شده با ❤️ توسط پیشرو پیامک