البداية السريعة
أرسل رسالتك الأولى في دقائق معدودة
سجل دخولك إلى لوحة التحكم واحصل على مفتاح API الخاص بك من قسم الإعدادات.
استخدم الكود التالي لإرسال رسالتك الأولى:
curl -X POST https://api.imissive.com/v1/sms/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+966501234567",
"message": "Hello from iMissive!",
"sender_id": "MyCompany"
}'* استبدل YOUR_API_KEY بمفتاح API الفعلي. نقاط النهاية وبيانات الاعتماد للإنتاج تُقدم بعد التعاقد وتفعيل الحساب.
المصادقة
جميع طلبات API تتطلب مصادقة عبر Bearer Token
Authorization: Bearer YOUR_API_KEY
أضف هذا الرأس إلى جميع طلبات API الخاصة بك. مفاتيح API متاحة من لوحة التحكم.
- لا تشارك مفتاح API الخاص بك أبداً
- استخدم متغيرات البيئة لتخزين المفاتيح
- قم بتدوير المفاتيح بانتظام
- استخدم HTTPS دائماً
SMS API
إرسال رسائل نصية فردية أو جماعية
{
"to": "+966501234567",
"message": "Your message content here",
"sender_id": "MyCompany",
"scheduled_at": "2024-01-15T10:00:00Z" // optional
}{
"messages": [
{ "to": "+966501234567", "message": "Hello User 1" },
{ "to": "+966501234568", "message": "Hello User 2" }
],
"sender_id": "MyCompany"
}OTP API
إنشاء والتحقق من رموز التحقق لمرة واحدة
{
"phone": "+966501234567",
"length": 6, // 4-8 digits
"expiry": 300, // seconds (configurable)
"template": "Your verification code is: {code}"
}{
"otp_id": "otp_abc123",
"code": "123456"
}Webhooks
استقبل إشعارات فورية عن حالة الرسائل
قم بتكوين عنوان URL الخاص بك من لوحة التحكم لاستقبال الإشعارات.
POST https://your-server.com/webhook
{
"event": "message.delivered",
"message_id": "msg_abc123xyz",
"timestamp": "2024-01-15T10:01:23Z",
"data": {
"to": "+966501234567",
"status": "delivered",
"delivered_at": "2024-01-15T10:01:22Z"
}
}message.queuedالرسالة في قائمة الانتظارmessage.sentتم إرسال الرسالةmessage.deliveredتم تسليم الرسالةmessage.failedفشل تسليم الرسالةاتصال SMPP
اتصال SMPP v3.4 للمؤسسات ذات الحجم الكبير
SMPP v3.4* بيانات اعتماد SMPP ومعلومات الاتصال متاحة بعد إتمام التعاقد الفني للعملاء المؤهلين
- دعم Unicode للرسائل العربية
- الرسائل الطويلة (التقسيم التلقائي)
- تقارير التسليم (DLR)
- جدولة الرسائل
- اتصالات متعددة
حدود الاستخدام
تعتمد حدود الاستخدام والإنتاجية على تكوين الحساب المعتمد والمسار ونوع المرسل والاتفاقية التجارية
* تواصل مع فريق المبيعات للحصول على تفاصيل الحدود الخاصة بحسابك
X-RateLimit-Limit: <account_limit> X-RateLimit-Remaining: <remaining_quota> X-RateLimit-Reset: <reset_timestamp>
رموز الأخطاء
مرجع رموز الأخطاء الشائعة وكيفية التعامل معها
400طلب غير صالح
تحقق من صحة البيانات المرسلة
401غير مصرح
مفتاح API غير صالح أو مفقود
403محظور
ليس لديك صلاحية لهذا الإجراء
429طلبات كثيرة
تم تجاوز حد الاستخدام
500خطأ في الخادم
حاول مرة أخرى لاحقاً
INVALID_PHONEرقم الهاتف غير صالحINVALID_SENDERمعرف المرسل غير مصرحINSUFFICIENT_CREDITSرصيد غير كافٍMESSAGE_TOO_LONGالرسالة تتجاوز الحد المسموحالأسئلة الشائعة
إجابات على الأسئلة الأكثر شيوعاً
أمثلة الكود
أمثلة سريعة للبدء في الدمج
curl -X POST https://api.imissive.com/v1/sms/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+966501234567",
"message": "Hello from iMissive!",
"sender_id": "MyCompany"
}'هل أنت مستعد لبدء التكامل؟
تواصل معنا للحصول على مفاتيح API الخاصة بك والبدء في دمج خدمات الرسائل المؤسسية