دليل ربط وتوثيق Rowmini SMS API
توفر بوابة Rowmini SMS واجهة برمجية فائقة السرعة لإرسال رسائل التحقق (OTP) والرسائل النصية الترويجية والإشعارات، مع ضمان تسليم فوري وتشفير بنكي كامل.
https://sms.rowmini.com/api/v1/otp
# 1. البداية السريعة (Quickstart)
للبدء في الإرسال، تحتاج فقط إلى أمرين:
يتم إصداره فوراً عند تفعيل حسابك (مثال: rm_live_...).
يمكنك استخدام الأسماء المرخصة فوراً أو تسجيل اسم رسمي خاص باسم شركتك.
# 2. المصادقة وتأمين المفاتيح (Authentication)
تتم المصادقة عبر تمرير مفتاحك السري في ترويسة الطلب X-Api-Key أو كـ Bearer Token.
X-Api-Key: rm_live_aqabago_348f27ae-63e9-4ca5
Content-Type: application/json
/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" }'
{
"success": true,
"message_id": 115,
"job_id": "92481023",
"recipient": "0791234567",
"sender": "Rowmini",
"balance": 499,
"cost_credits": 1,
"sent_at": "2026-10-11T12:00:00Z"
}
/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 دقائق) والتحقق منه تلقائياً عبر نقطتين:
يرسل الكود للمستلم ويعيد لك session_id دون كشف الكود في الواجهة.
تمرر له session_id والكود المدخل من المستخدم ويؤكد صحته فوراً.
4. أكواد الردود والأخطاء (Error Handling)
| الكود | الحالة | المعنى والإجراء |
|---|---|---|
| 200 OK | نجاح | تم إرسال الرسالة بنجاح واستلمها مزود الاتصالات. |
| 401 Unauthorized | غير مصرح | مفتاح الـ API مفقود أو غير صحيح. تأكد من قيمة X-Api-Key. |
| 402 Payment Required | الرصيد نفد | رصيدك الحالي هو 0. يرجى شحن الرصيد من لوحة التحكم لمتابعة الإرسال. |
| 403 Forbidden | حساب موقوف | الحساب معطل مؤقتاً. تواصل مع الدعم الفني لتفعيله. |
| 502 Bad Gateway | رفض المزود | رقم الهاتف خاطئ أو رُفض الإرسال. تم استرجاع الرصيد آلياً. |
جرّب الاستدعاء الحي من المتصفح مباشرة
// Response will appear here after clicking Send...