Rowmini SMS
RESTful API Reference | JSON Payload

دليل ربط وتوثيق Rowmini SMS API

توفر بوابة Rowmini SMS واجهة برمجية فائقة السرعة لإرسال رسائل التحقق (OTP) والرسائل النصية الترويجية والإشعارات، مع ضمان تسليم فوري وتشفير بنكي كامل.

النطاق الأساسي المعتمد للـ API: https://sms.rowmini.com/api/v1/otp

# 1. البداية السريعة (Quickstart)

للبدء في الإرسال، تحتاج فقط إلى أمرين:

1. مفتاح API سري (API Key)

يتم إصداره فوراً عند تفعيل حسابك (مثال: rm_live_...).

2. اسم مرسل معتمد (Sender ID)

يمكنك استخدام الأسماء المرخصة فوراً أو تسجيل اسم رسمي خاص باسم شركتك.

# 2. المصادقة وتأمين المفاتيح (Authentication)

تتم المصادقة عبر تمرير مفتاحك السري في ترويسة الطلب X-Api-Key أو كـ Bearer Token.

# Header Authentication Example:
X-Api-Key: rm_live_aqabago_348f27ae-63e9-4ca5
Content-Type: application/json
POST /api/v1/otp/send

إرسال رسالة OTP أو نصية مخصصة

تقوم هذه النقطة بإرسال رسالة نصية فورية إلى رقم الهاتف المخصص بخصم نقطة واحدة من رصيدك، مع تفعيل تشفير OTP التلقائي لدى شبكات الاتصالات.

متغيرات الطلب (Request JSON Body)

الحقل النوع إلزامي؟ الوصف
phone string نعم رقم الهاتف المحلي أو الدولي (مثل 0791234567 أو 962791234567)
message string نعم محتوى رسالة الـ OTP أو النص المراد إرساله
senderName string اختياري اسم المرسل المراد استخدامه (إذا لم يُحدد يعتمد اسم حسابك الافتراضي)
reference string اختياري رقم مرجعي لطلبك أو كود العملية لربطه في سجلاتك
أمثلة برمجية للاستدعاء:
curl -X POST https://sms.rowmini.com/api/v1/otp/send \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: rm_live_your_key_here" \
  -d '{
    "phone": "0791234567",
    "message": "رمز التحقق الخاص بك هو 591240",
    "senderName": "Rowmini",
    "reference": "ORDER-9182"
  }'
نموذج الرد الناجح (HTTP 200 OK):
{
  "success": true,
  "message_id": 115,
  "job_id": "92481023",
  "recipient": "0791234567",
  "sender": "Rowmini",
  "balance": 499,
  "cost_credits": 1,
  "sent_at": "2026-10-11T12:00:00Z"
}
GET /api/v1/otp/balance

الاستعلام عن الرصيد وحالة الحساب

يتيح لك معرفة رصيدك المتبقي لحظياً، اسم مرسلك، وعدد الرسائل المستهلكة.

curl -X GET https://sms.rowmini.com/api/v1/otp/balance \
  -H "X-Api-Key: rm_live_your_key_here"

3. التوليد والتحقق التلقائي (Managed OTP)

إذا كنت لا ترغب في توليد وحفظ أرقام الـ OTP في قاعدة بياناتك بنفسك، توفر لك Rowmini ميزة توليد الكود عشوائياً وتخزينه بصلاحية مؤقتة (5 دقائق) والتحقق منه تلقائياً عبر نقطتين:

POST /api/v1/otp/generate-and-send

يرسل الكود للمستلم ويعيد لك session_id دون كشف الكود في الواجهة.

POST /api/v1/otp/verify

تمرر له session_id والكود المدخل من المستخدم ويؤكد صحته فوراً.

4. أكواد الردود والأخطاء (Error Handling)

الكود الحالة المعنى والإجراء
200 OK نجاح تم إرسال الرسالة بنجاح واستلمها مزود الاتصالات.
401 Unauthorized غير مصرح مفتاح الـ API مفقود أو غير صحيح. تأكد من قيمة X-Api-Key.
402 Payment Required الرصيد نفد رصيدك الحالي هو 0. يرجى شحن الرصيد من لوحة التحكم لمتابعة الإرسال.
403 Forbidden حساب موقوف الحساب معطل مؤقتاً. تواصل مع الدعم الفني لتفعيله.
502 Bad Gateway رفض المزود رقم الهاتف خاطئ أو رُفض الإرسال. تم استرجاع الرصيد آلياً.
مختبر الـ API التفاعلي

جرّب الاستدعاء الحي من المتصفح مباشرة

Sandbox Live
Response Output (JSON):
// Response will appear here after clicking Send...