مكتبة SMS 4Jawaly لـ Ruby

مكتبة Ruby للتعامل مع خدمة الرسائل القصيرة من 4Jawaly

التثبيت

gem install sms4jawaly

الاستخدام

تهيئة المكتبة

require 'sms4jawaly'

# قم بتعيين مفاتيح API الخاصة بك
gateway = Sms4jawaly::Gateway.new('YOUR_API_KEY', 'YOUR_API_SECRET')

الاستعلام عن الرصيد

balance = gateway.get_balance
puts balance

جلب أسماء المرسلين

senders = gateway.get_senders
puts senders

إرسال رسالة

message = "تجربة الارسال من منصه فورجوالي لغة البرمجة روبي"
numbers = ["966500000000"]  # رقم الجوال المستهدف
sender = "4jawaly"  # اسم المرسل المعتمد

result = gateway.send_sms(message, numbers, sender)
puts result

ملاحظات هامة

  1. قم بتغيير YOUR_API_KEY و YOUR_API_SECRET بمفاتيح API الخاصة بك
  2. تأكد من استخدام اسم مرسل معتمد في حسابك
  3. أرقام الجوال يجب أن تكون بالصيغة الدولية (مثال: 966500000000)

التطوير

# تثبيت التبعيات
bundle install

# تشغيل الاختبارات
bundle exec rake test

# توليد التوثيق
bundle exec rake yard

المساهمة

  1. Fork المشروع
  2. إنشاء فرع للميزة (git checkout -b feature/amazing-feature)
  3. Commit التغييرات (git commit -m 'Add some amazing feature')
  4. Push إلى الفرع (git push origin feature/amazing-feature)
  5. فتح Pull Request

الترخيص

MIT License