ابدأ هنا

طلبك الأول في أربع خطوات

(أ) إنشاء حساب ونسخ مفتاح (زكرادك زدز من لوحة التحكم

ضعي التطبيق المتنقل وتأكدي أن الجهاز على الإنترنت

أرسل جهازاً واحداً من أجهزة الإستخبارات المركزية مع النهايات/النتائج/النقطة النهائية

تخزين هوية الرسالة المعادة لربط سجلات و حالة التسليم.

تطبيق الجوال SMSMobileAPI الآمن الذي يربط الهاتف بلوحة تحكم الويب وREST API لعمليات الرسائل القصيرة والمكالمات — اتصال مشفر من الهاتف المحمول إلى النظام الأساسي

تطبيق الهاتف المحمول الرسمي

الجسر الآمن بين هاتفك ولوحة المعلومات وواجهة برمجة التطبيقات.

تمر عمليات الرسائل القصيرة والمكالمات عبر تطبيق SMSMobileAPI الرسمي المثبت على هاتفك المتصل. يقوم التطبيق بإقران الجهاز بحسابك بشكل آمن، ومزامنة الأحداث المصرح بها، وربط شبكة الجوال بلوحة التحكم وواجهة برمجة التطبيقات REST.

1تطبيق الجوالإقران الهاتف وشريحة SIM الخاصة به 2رابط مشفريصادق البيانات ويحميها في العبور 3لوحة التحكم وواجهة برمجة التطبيقاتتتحكم في سير العمل والنشاط

الإصدارات الموقعة الموزعة من خلال قوائم Google Play وApple App Store الرسمية
عناصر التحكم في المراجعة والتوقيع والتوزيع لنظامي Google وApple الأساسيين
إقران آمن للجهاز، ونقل HTTPS، والوصول إلى واجهة برمجة التطبيقات المصادق عليها
فقط الأذونات المطلوبة لميزات الهاتف المحمول التي تقوم بتمكينها

احصل على تطبيق SMSMobileAPI الرسمي على Google Play

تحميل التطبيق الرسمي للزجاجة SMSMobileAPI على جهاز التفريغ App Store

تعتمد الإمكانيات على الأذونات والوصول إلى الخلفية التي يسمح بها Android أو iOS.

WEBHOOK V2 لواجهة API هذه

اشترك فقط في أحداث الأجهزة المحمولة التي يحتاجها سير عملك.

5 نوعًا من الأحداث

يمكن لوجهة واحدة استقبال كل شيء، أو يمكنك فصل أنظمة الإنتاج والتحليلات والتنبيهات التشغيلية. كل حدث له اسم دقيق حتى يتعامل تطبيقك معه بشكل متوقّع.

sms.api.submitted

تم تقديم SMS عبر API

أنشأ طلب API مهمة إرسال SMS. مفيد للاعتراف بأن الطلب دخل إلى المنصة.

sms.sent

تم إرسال SMS

أكد الجهاز المحمول المتصل عملية إرسال SMS.

sms.failed

فشل SMS

الهاتف المتصل أعاد خطأً أثناء إرسال SMS.

sms.received

SMS تم استلامه.

قام الهاتف المتصل بمزامنة SMS وارد.

sms.mobile.sent

SMS أُرسل من الهاتف.

تم إرسال SMS يدويًا من الهاتف المتصل.

المصادقة

حافظ على أوراق اعتمادك على خادمك

كل طلب يقبل مفتاح API من خلال بارامتر البيكي. كما تتاح وثائق تفويض العملاء من طراز OAuth2 لتكامل الخواديم إلى المواظب. لا تكشف أبداً مفتاح الإنتاج في رموز المروج، مستودعات عامة أو رسائل دعم.

إدارة التاريخ

تاريخ واضح بأمان: استعراض أولي، حذف، متابعة التقدم

هذه النقط النهائية تُوضّح تاريخ الخادم المختار لك API مفتاح، وليس رسائل على الهواتف أو الخدمات الخارجية. ولا توفر هذه البلدان فترة من الحساب. النشاط الجديد يمكن أن يظهر بعد الإنزال

اقرأ request_id دليل إعادة التأهيل

حماية التكامل

وبحسب التخلف، تظل السجلات المرتبطة أو المعالجة مرئية. فقط استخدام include_linked=1 إذا قبلت أن الإدماج أو التجهيزات الجارية قد تتوقف عن العمل

كيف request_id الأشغال

تمهيد العد action=previewلا request_id ويلزم عدم حذف أي سجلات.
جيل فريد request_id لحذف جديد، على سبيل المثال UUIDأنقذه قبل إرساله action=delete-
للمراكز أو الإجازات أو HTTP 202، إعادة استخدام نفس API مفتاح، نقطة نهاية التاريخ، request_id و include_linked قيمة لا تولد هوية جديدة تلقائياً بعد خطأ
عندما completed=trueلقد انتهت العملية ويعود استخدام بطاقة هويتها بنفس النتيجة بدلا من حذف السجلات التي وصلت حديثا. استخدم هوية جديدة فقط لتنظيف جديد متعمد

request_id يحدد عملية حذفك، وليس فرد SMSالشكل المسموح به: ١٦-١٢٨ ASCII رسائل، أرقام، فيتامينات أو تأكيدات ألف UUID مُولّد بالبريدوتو..

يُنفذ الحذف على دفعات. إذا كانت الاستجابة HTTP 202 ومعها continue_required=true، فأعد طلب action=delete بعد 3 ثوانٍ. لا تعمل مهمة cron في الخلفية. يقرأ action=status التقدم فقط ولا يتابع الحذف، حتى لو كانت الاستجابة HTTP 200.

أمثلة للحذف والوضع

يستعاض عن العينة request_id مع قيمتك الفريدة قبل أن تبدأ وتُغيّر الطلبات الواردة أدناه تاريخ الحساب الحقيقي؛ وهي ليست استعراضات مسبقة.

POST · API المفتاح

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

POST ; OAuth2

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET :: الوضع

curl -G "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET أيضاً تقبل action=preview أو action=delete- POST يوصى بما يلي: يمكن أن تتسرب البارامترات الأوروبية إلى تاريخ المروج وسجلات الخواديم. لا تضع أبداً انحرافاً في حلقة عامة أو صورة أو مفترقة

للاستعداد POSTأرسل كل المعالم في هيئة أو JSON اعترض، لا يوجد في سلسلة الاستفسارات وتُرفض المعايير غير المعروفة؛ ولا تدعم المواصفات المتحركة أو المرشّحات.

التوثيق بالنسبة لنقاط نهاية التاريخ

الاستخدام apikey أو Authorization: Bearer منفذ SMSMobileAPI OAuth2لا ترسلوا مركباً جديداً أو API مفتاح كـ Bearer مُتَحدّد. تم رفض المكسورين المفصولين

عندما يتم تحديد النطاقات history:read يسمح بالفحص الأولي/الوضع history:delete كما يسمح بالحذف. القيود المفروضة على كل من المكسورين OAuth زبونة تتقدم وتحتفظ المكسورات غير المزودة بنطاقات بالحسابات الموجودة.

OAuth2 يختارون المُصدر الفريد API مفتاح إذا كان هناك عدة مفاتيح رئيسية، تقدم أيضاً apikey لاختيار واحد من ممتلكات الحساب. مفاتيح الثانوية لا تسمح أبداً بالدخول إلى التاريخ الرئيسي

اقرأ الرد قبل مواصلة

count_delete هو العدد التراكمي الذي أزالته هذه العملية. selected_at_start (أ) الاختيار الأولي؛ protected_at_start يحسب السجلات المستبعدة. الاستخدام preview.linked_or_processing حتى عندما يُحسب include_linked=1-

JSON ; HTTP 202

{
    "result": {
        "error": 0,
        "history": "sms-api",
        "action": "delete",
        "request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
        "status": "processing",
        "completed": false,
        "count_delete": 100,
        "total_before": 250,
        "selected_at_start": 200,
        "protected_at_start": 50,
        "include_linked": 0,
        "continue_required": true,
        "message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
    }
}

200 مع completed=true: أنهيت ولا يثبت أن هناك 200 من الردود المسبقة أو الحالة لا تكتمل وحدها.
400 INVALID_REQUEST_ID: تحقق من الشكل 404 REQUEST_NOT_FOUNDلا توجد عملية لهذا الهوية API مفتاح وتاريخ
401: وثائق تفويض غير صحيحة أو منتهية الصلاحية. 403: عدم كفاية نطاق OAuth أو حساب غير مأذون به.
409 HISTORY_BUSY: تطهير آخر يجري؛ مواصلة تشغيله من العميل الأصلي. 409 INCLUDE_LINKED_CONFLICT: اعيدوا الأصل include_linked قيمة
409 OAUTH_ACCOUNT_AMBIGUOUS: توفير API مفتاح هذا الحساب
503 أو انقطاع الشبكات: قد تكتمل بالفعل بعض الخفافيش. التكوين الشيكى، ثم العودة مع الأصلي request_id- لا تخلق عملية بديلة تلقائيا.

POST ; GET

أرسلوا جهاز الأمن الخاص

نهاية الفقرةhttps://api.smsmobileapi.com/sendsms/

أرسل رسالة على هاتف متصل ويوصى بقسم البريد الإلكتروني عندما تكون الرسالة طويلة أو تتضمن خصائص خاصة.

متى تستخدمه

استخدام هذا في رسائل المعاملات، والتذكير، والإنذارات، وأجهزة الاستشعار المولدة للتطبيقات.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`recipients`	الهاتف	مطلوب	رقم الوجهة في الشكل الدولي.
`message`	خيط	مطلوب	جثة رسالة امسحها عندما تستخدم جي تي
`port`	1 \| 2	الاختياري	SIM port on compatibleAndroidأجهزة؛ ترك فارغة للاختيار التلقائي.
`sIdentifiant`	خيط	الاختياري	جهاز SID الهاتفي المحدد الموصل؛ إترك فارغاً للجهاز المتاح الأول.
`shorturl`	0 \| 1	الاختياري	من 1 إلى 1 إلى تقصير المباريات التي عثر عليها في الرسالة
`sendsms`	0 \| 1	الاختياري	علم قناة إس إس إس إس إس. التخلف عن الدفع إلى 1 عندما يُحذف.
`sendwa`	0 \| 1	الاختياري	كما يطلب تسليم WhatsApp عندما يدعمه الحساب.
`encrypt_message`	نعم	الاختياري	أدخل الرسالة إلى جانب المتلقي للقراءة المحمية
`schedule_timestamp`	ثواني	الاختياري	وقت إرسال الرسالة منه.

مثال

حليقة

curl -X POST "https://api.smsmobileapi.com/sendsms/" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=+1234567890" \
  --data-urlencode "message=Your appointment is confirmed for tomorrow."

مثال على الإجابة

JSON

{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25",
    "note": "sent by mobile",
    "datetime": "2026-03-20T21:07:44Z",
    "port": null,
    "send_with_whatsapp": "0"
  }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

تعني استجابة API الناجحة أن المنصة قبلت الرسالة؛ احتفظ بالمعرّف المستلم لتتبعها لاحقًا.
ويمكن أن يحدث تسليم الناقلين وتجهيزهم بالهواتف المحمولة بعد استجابة HTTP.

POST ; GET

إعادة إرسال رسالة نصية قصيرة غير مرسلة

نهاية الفقرةhttps://api.smsmobileapi.com/resend/

يُذكر رسالة في حالة خطأ حالياً.

متى تستخدمه

استخدم هذا بعد فحص سجل الشحنات المرسلة وتأكيد أن الرسالة الفاشلة مؤهلة لمحاولة أخرى

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`guid`	خيط	مطلوب	وعادت الرسالة التي وجهها فريق غويد من نقطة النهاية التي أرسلت أو سجلت.

مثال

حليقة

curl "https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE"

مثال على الإجابة

JSON

{
  "result": {
    "error": "0",
    "sms": "resent with successfully",
    "attempt": 1
  }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

الرسائل التي لها حالة خطأ هي فقط التي يمكن أن تكون مستاءة

يحصل

قائمة بأجهزة الأمن الخاصة التي أرسلت من مكتب التحقيقات

نهاية الفقرةhttps://api.smsmobileapi.com/log/sent/sms/

Res messages submitted through the SMS API with queue, mobile and error information.

متى تستخدمه

استخدامه في رصد التنفيذ، ودعم التشخيص والمصالحة.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`guid_message`	خيط	الاختياري	ارجع رسالة واحدة من قبل رجلها الفريد
`before`	الزمان أو المرجع	الاختياري	ارجع رسائل قبل الضمادات أو المصباح
`error_api`	0 \| 1	الاختياري	حددوا إلى 1 لإرجاع أخطاء تجهيز API فقط.
`error_mobile`	0 \| 1	الاختياري	جهزوا إلى 1 لإرجاع أخطاء إرسال متحركة فقط
`keyword`	خيط	الاختياري	ابحث عن رقم المتلقي أو رسالة نصية

مثال

حليقة

curl "https://api.smsmobileapi.com/log/sent/sms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

مثال على الإجابة

JSON

{
  "result": {
    "error": "0",
    "sms": [{
      "sIdentifiantPhone": "508b004b4aadacc4",
      "recipients": "+1234567890",
      "sms": "Test message",
      "guid_message": "MESSAGE_GUID",
      "send_from_mobile": 1,
      "error_api": "",
      "send_from_mobile_erreur": ""
    }]
  }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

يحصل

قائمة SMS تزامنت من الهاتف

نهاية الفقرةhttps://api.smsmobileapi.com/log/sent/frommobile/

قوائم SMS أرسلت من الناحية المادية بواسطة متنقل ومتزامنة مع المنصة.

متى تستخدمه

استخدمها عندما تكون الرسائل منبثقة على الهاتف وكذلك من خلال الـ (زكى 8ك زى)

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`date`	YYYY-MMM-DD	الاختياري	أُخرِج موعداً واحداً بالضبط
`date_from`	YYYY-MMM-DD	الاختياري	بدء من نطاق التأريخ
`date_to`	YYYY-MMM-DD	الاختياري	نهاية نطاق التأريخ
`period`	enum	الاختياري	اليوم، أمس، آخر 24 ساعة، آخر 3 أيام أو 7 أيام.
`number`	الهاتف	الاختياري	مُصور من قبل المُتلقي.
`sIdentifiant`	خيط	الاختياري	مُصور بواسطة جهاز مُتنقل مُتصل.
`message`	خيط	الاختياري	مُصور بمحتوى الرسالة
`search`	خيط	الاختياري	البحث العالمي عبر المحركات ورقم ورسالة ومصابيح الزمان
`sort_by`	enum	الاختياري	مُحدّد، رقم، رسالة، مُحدّد مُتنقل، مُحدّد مُتنقل، مُحدّد رسمي أو مُتزامن.
`sort_order`	(أك)	الاختياري	إتجاه حساس
`limit`	ثلاجة	الاختياري	أكبر 200 سجل

مثال

حليقة

curl "https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200"

مثال على الإجابة

JSON

{
  "result": {
    "error": "0",
    "count": 1,
    "history_limit_days": 7,
    "sms": [{
      "sIdentifiant": "508b004b4aadacc4",
      "number": "+15551234567",
      "message": "Appointment confirmed.",
      "mobile_date_ms": 1774041004692,
      "synchro_time": "2026-03-20 21:10:05"
    }]
  }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

(ب) اشتراطات رقم Android)(
هذه النقطة النهائية تعود إلى حد أقصى 7 أيام من التاريخ المتزامن.

يحصل

القائمة الواردة

نهاية الفقرةhttps://api.smsmobileapi.com/getsms/

عودة جهاز الأمن الخاص القادم متزامن من الهواتف الموصله

متى تستخدمه

استخدمه لبناء صندوق، أو استطلاع للردود أو استرجاع الرسائل بعد انقطاع شبكة ويب هوك.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`sIdentifiantPhone`	خيط	الاختياري	مُصور من الهاتف الذي إستلم جهاز الإستخبارات
`after_timestamp_unix`	ثواني	الاختياري	رسائل العودة التي وردت بعد هذا العصر
`onlyunread`	نعم	الاختياري	لا ترد سوى رسائل غير مكتوبة على النحو المُقرأ في ولاية API.

مثال

حليقة

curl "https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY&onlyunread=yes"

مثال على الإجابة

JSON

{
  "result": {
    "error": "",
    "sms": [{
      "id": 466340,
      "sIdentifiantPhone": "508b004b4aadacc4",
      "timestamp_unix": 1774041814,
      "message": "Please call us back.",
      "number": "+15551234567",
      "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
      "alias": null
    }]
  }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

POST ; GET

مارك أُستلمت SMS كما يلي:

نهاية الفقرةhttps://api.smsmobileapi.com/getsms/set-read/

علامة واحدة تلقت رسالة كما يلي:SMSMobileAPIولاية "آبي"

متى تستخدمه

استخدم هذا بعد أن جهز طلبك رسالة واردة

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`guid_message`	خيط	مطلوب	رجل من جهاز الأمن الخاص المستلم

مثال

حليقة

curl "https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

هذا لا يغير الدولة القارئة في طلب التراسل الهاتفي

POST ; GET

تحديث المعلومات الواردة من فصيلة SMS

نهاية الفقرةhttps://api.smsmobileapi.com/getsms/update/

يضاف أو يغير أو يوضح الاسم المستعار المرتبط بجهاز استرجاع المعلومات.

متى تستخدمه

استخدام الأسماء المستعارة لإرفاق اسم اتصال أو بطاقة تطبيق على رسالة.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`guid`	خيط	مطلوب	رجل من جهاز الأمن الخاص المستلم
`alias`	خيط	مطلوب	اسم مستعار جديد أرسل قيمة فارغة لتخليصها

مثال

حليقة

curl "https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID&alias=John%20Doe"

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

POST ; GET

تحذف سجلات الخواديم

نهاية الفقرةhttps://api.smsmobileapi.com/deletesms/

تحذف سجلات نظام الرصد الخاص من سجل خادم SMSMobileAPI.

متى تستخدمه

استخدمها في سير العمل أو إزالة رسالة محددة مُسجلة.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`guid_message`	خيط	الاختياري	تحذف رسالة واحدة من قِبل منظمة غيديه.
`date_start`	YYYY-MMM-DD	الاختياري	تحذف السجلات من هذا التاريخ.
`date_end`	YYYY-MMM-DD	الاختياري	مع التاريخ (البداية) ، يحد من نطاق الحذف

مثال

حليقة

curl "https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

مثال على الإجابة

JSON

{
  "result": {
    "error": null,
    "count_delete": 1
  }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

هذا يحذف قيودات سجل الخوادم فقط لا تحذف الرسائل المخزنة على الجهاز المحمول
عالج هذه العملية كمدمر وتحقق من المرشّح قبل أن يطلق عليها

يحصل

قائمة محادثات الرسائل النصية القصيرة

نهاية الفقرةhttps://api.smsmobileapi.com/conversation/sms/list/

مجموعات الرسائل القادمة والمنبثة في المحادثات حسب رقم الهاتف

متى تستخدمه

استخدمه للحديث عن الآراء، وحديثك عن النوافذ و دعم الجداول الزمنية

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`origineConversation`	تم إرسالها	مطلوب	كانت مجموعة البيانات لتحديد المحادثات البادئة
`numero`	الهاتف	الاختياري	ارجعي محادثة رقم واحد
`date_from`	التاريخ أو التاريخ	الاختياري	ابدأي من نطاق الرسائل
`date_to`	التاريخ أو التاريخ	الاختياري	نهاية نطاق الرسالة
`sort`	(أك)	الاختياري	أمر التنويم؛ عدم التخلف عن إدارة الدعم الميداني.
`limit`	ثلاجة	الاختياري	الحد الأقصى للخلافات عند إغفال الرومي؛ التقصير 20
`resume`	0 \| 1	الاختياري	من البداية إلى 1 أن تعود فقط آخر الرسائل لكل محادثة
`resume_line_how`	ثلاجة	الاختياري	عدد الرسائل لكل محادثة عند استئنافها = 1.

مثال

حليقة

curl "https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&resume=1&resume_line_how=3"

مثال على الإجابة

JSON

{
  "success": true,
  "origineConversation": "received",
  "conversations": [{
    "phone_number": "+15551234567",
    "contact_alias": "John Doe",
    "messages": [{
      "direction": "incoming",
      "message_id": "msg_1001",
      "timestamp_utc": "2026-03-13T08:45:12Z",
      "message": "I need more information.",
      "status": "received",
      "mobile_sid": "device_sid_1"
    }]
  }]
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

يحصل

قائمة الهواتف المحمولة المتصلة

نهاية الفقرةhttps://api.smsmobileapi.com/gateway/mobile/list/

قوائم الهواتف المُتصلة بحساب بوابة نظام (SMS).

متى تستخدمه

استخدمه لاختيار مرسل أو مركز جهاز العرض أو مراجعة أسطول البوابة

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`sid`	خيط	الاختياري	أعد جهازاً متنقلاً
`search`	خيط	الاختياري	ابحث عن معلومات عن هوية المعلمين، وتاريخهم، وبطارية، ونسختهم، وعلاماتهم، وميادينهم ذات الصلة.

مثال

حليقة

curl "https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY"

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

POST ; GET

تحديث متنقل متصل

نهاية الفقرةhttps://api.smsmobileapi.com/gateway/mobile/update/

تحديث العلامة البشرية القابلة للقراءة أو رقم هاتف جهاز متصل

متى تستخدمه

استخدمه لإبقاء علامات الأجهزة ذات مغزى في تركيبات متعددة الهواتف

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`sid`	خيط	مطلوب	جهاز SID.
`label`	خيط	مطلوب	بطاقة جديدة، قد تكون فارغة عن قصد
`phone_number`	الهاتف	الاختياري	رقم قياسي جديد

مثال

حليقة

curl "https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=DEVICE_SID&label=OfficePhone"

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

POST ; GET

حذف هاتف محمول متصل

نهاية الفقرةhttps://api.smsmobileapi.com/gateway/mobile/delete/

يزيل هاتف متنقل متصل و صفوف تاريخ بوابة

متى تستخدمه

لا تستخدم إلا عندما يجب أن يتم سحب الهاتف من الحساب بشكل دائم

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	حسابك (زكى 8كى زى)
`sid`	خيط	مطلوب	جهاز مقطعي من الجهاز

مثال

حليقة

curl "https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=DEVICE_SID"

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

هذه العملية تزيل تاريخ الأجهزة المرتبطة بجهاز المخابرات تأكد من الجهاز قبل أن يسميه

في مرحلة ما بعد الدخول

جهاز استقبال مرسل عبر شبكة ويب

دال - الحسـنYour HTTPS endpoint

SMSMobileAPIيرسل طلبًا من (الجوسون) إلى (يورل) المُحدّد عندما يتمّ تلقيّ مذكرة تفاهم.

متى تستخدمه

استخدام أجهزة الاتصال الشبكي لتجهيزها في الوقت الحقيقي بدلا من الاقتراع المتكرر.

مثال استقبال

PHP

<?php
$payload = json_decode(file_get_contents('php://input'), true);
if (!is_array($payload) || empty($payload['guid'])) {
    http_response_code(400);
    exit('Invalid payload');
}
// Queue the event, then acknowledge quickly.
http_response_code(200);
echo 'OK';

مثال على الإجابة

JSON

{
  "date": "2026-03-20",
  "hour": "10:15:00",
  "time_received": "2026-03-20 10:14:50",
  "message": "Hello, this is a test.",
  "number": "+123456789",
  "guid": "abcde12345"
}

نقطة النهاية

هذه النقطة النهائية تستقبل أحداثاً في موقعك الخاص (زكس كي 11 كيزو) استخدمي مثال جهاز الإستقبال عالياً ثم أرسلي جهازاً لجهاز التجسس إلى هاتفكِ المُتصل لتختبريه

من الجيد معرفة

اثقوا بالزجاجة العامة (زكس كي 11) في (داشوت)
عودوا بسرعة 200 كيلو متر مربع وجهزوا الحدث بحذر
بقايا الطعام باستخدام الغييد

POST ; GET

مسح سجل رسائل SMS المرسلة عبر API

نهاية الفقرةhttps://api.smsmobileapi.com/delete-history-sms-api/

سجلات الخادم SMS مقدمة عن طريق APIلا يتذكر رسالة جمعها هاتف بالفعل.

متى تستخدمه

استخدمي العرض الأول، وتحققي من التهم، ثم طلبي حذفها صراحة. هذا يُوضّحُ التاريخَ المختارَ بالكاملَ ل API مفتاح، بدون موعد، هاتف أو مرشحات رسائل

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	الاختياري	مطلوبة بدون OAuth2مع OAuth2اختيار اختياري API مفتاح الحساب نفسه
`action`	ما قبل الاستعراض تحذف \| الحالة	الاختياري	preview يحسب السجلات دون حذف؛ delete يبدأ الحذف أو يتابعه؛ status يعرض التقدم فقط. القيمة الافتراضية في API هي delete، وفي أداة الاختبار هذه هي preview.
`include_linked`	0 \| 1	الاختياري	الافتراض صفر: الاحتفاظ بسجلات متصلة أو تجهيز. وضع 1 لضمها، مع خطر كسر التكامل. أبق هذه القيمة دون تغيير عندما تستمر في الحذف
`request_id`	خيط	الاختياري	مطلوب مع delete وstatus، واختياري مع preview. استخدم من 16 إلى 128 حرف ASCII أو رقم أو شرطة (-) أو شرطة سفلية (_). أنشئ معرّفًا فريدًا لكل عملية حذف جديدة واحتفظ به في جميع المحاولات المتكررة. هذا ليس معرّف رسالة ولا مفتاح API.

مثال

حليقة

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"

أمثلة للحذف والوضع

POST · API المفتاح

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

POST ; OAuth2

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-api/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET :: الوضع

curl -G "https://api.smsmobileapi.com/delete-history-sms-api/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

مثال على الإجابة

JSON

{
    "result": {
        "error": 0,
        "history": "sms-api",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

المثال الوارد أعلاه هو استعراض مسبق، وليس حذف. فالعدادات توضيحية؛ والاختيار النهائي يتم تحديده عند بدء حذفها.
include_linked=1 قد يُعطل GHL، Zapierأو آليات أو وصلات غير مصففة أو تتبع تسليم. لا يتعدى على حساب الملكية أو فحص سلامة التخزين

POST ; GET

مسح سجل رسائل SMS المرسلة من الهاتف

نهاية الفقرةhttps://api.smsmobileapi.com/delete-history-sms-mobile/

سجلات متزامنة SMS أرسل من الهواتف المحمولة، وليس الرسائل المخزنة على الهواتف.

متى تستخدمه

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	الاختياري	مطلوبة بدون OAuth2مع OAuth2اختيار اختياري API مفتاح الحساب نفسه
`action`	ما قبل الاستعراض تحذف \| الحالة	الاختياري	preview يحسب السجلات دون حذف؛ delete يبدأ الحذف أو يتابعه؛ status يعرض التقدم فقط. القيمة الافتراضية في API هي delete، وفي أداة الاختبار هذه هي preview.
`include_linked`	0 \| 1	الاختياري	الافتراض صفر: الاحتفاظ بسجلات متصلة أو تجهيز. وضع 1 لضمها، مع خطر كسر التكامل. أبق هذه القيمة دون تغيير عندما تستمر في الحذف
`request_id`	خيط	الاختياري	مطلوب مع delete وstatus، واختياري مع preview. استخدم من 16 إلى 128 حرف ASCII أو رقم أو شرطة (-) أو شرطة سفلية (_). أنشئ معرّفًا فريدًا لكل عملية حذف جديدة واحتفظ به في جميع المحاولات المتكررة. هذا ليس معرّف رسالة ولا مفتاح API.

مثال

حليقة

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"

أمثلة للحذف والوضع

POST · API المفتاح

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

POST ; OAuth2

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET :: الوضع

curl -G "https://api.smsmobileapi.com/delete-history-sms-mobile/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

مثال على الإجابة

JSON

{
    "result": {
        "error": 0,
        "history": "sms-mobile",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

المثال الوارد أعلاه هو استعراض مسبق، وليس حذف. فالعدادات توضيحية؛ والاختيار النهائي يتم تحديده عند بدء حذفها.
include_linked=1 قد يُعطل GHL، Zapierأو آليات أو وصلات غير مصففة أو تتبع تسليم. لا يتعدى على حساب الملكية أو فحص سلامة التخزين

POST ; GET

مسح سجل رسائل SMS المستلمة

نهاية الفقرةhttps://api.smsmobileapi.com/delete-history-sms-received/

سجلات الخادم الجاهزة SMS- تُحمى سجلات التكامل والتشغيل الآلي من جراء التقصير.

متى تستخدمه

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	الاختياري	مطلوبة بدون OAuth2مع OAuth2اختيار اختياري API مفتاح الحساب نفسه
`action`	ما قبل الاستعراض تحذف \| الحالة	الاختياري	preview يحسب السجلات دون حذف؛ delete يبدأ الحذف أو يتابعه؛ status يعرض التقدم فقط. القيمة الافتراضية في API هي delete، وفي أداة الاختبار هذه هي preview.
`include_linked`	0 \| 1	الاختياري	الافتراض صفر: الاحتفاظ بسجلات متصلة أو تجهيز. وضع 1 لضمها، مع خطر كسر التكامل. أبق هذه القيمة دون تغيير عندما تستمر في الحذف
`request_id`	خيط	الاختياري	مطلوب مع delete وstatus، واختياري مع preview. استخدم من 16 إلى 128 حرف ASCII أو رقم أو شرطة (-) أو شرطة سفلية (_). أنشئ معرّفًا فريدًا لكل عملية حذف جديدة واحتفظ به في جميع المحاولات المتكررة. هذا ليس معرّف رسالة ولا مفتاح API.

مثال

حليقة

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=preview" -d "include_linked=0"

أمثلة للحذف والوضع

POST · API المفتاح

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

POST ; OAuth2

curl -X POST "https://api.smsmobileapi.com/delete-history-sms-received/" \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -d "action=delete" -d "include_linked=0" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

GET :: الوضع

curl -G "https://api.smsmobileapi.com/delete-history-sms-received/" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  -d "action=status" \
  -d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"

مثال على الإجابة

JSON

{
    "result": {
        "error": 0,
        "history": "sms-received",
        "action": "preview",
        "total": 120,
        "simple": 100,
        "linked_or_processing": 20,
        "selected": 100,
        "include_linked": 0,
        "operation_in_progress": false,
        "active_include_linked": null
    }
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

المثال الوارد أعلاه هو استعراض مسبق، وليس حذف. فالعدادات توضيحية؛ والاختيار النهائي يتم تحديده عند بدء حذفها.
include_linked=1 قد يُعطل GHL، Zapierأو آليات أو وصلات غير مصففة أو تتبع تسليم. لا يتعدى على حساب الملكية أو فحص سلامة التخزين

استكشاف الأخطاء وإصلاحها

السطو والمستودعات الآمنة

اقرأي حالة HTTP وميدان خطأ JSON قبل إعادة التجريب. لا تُعيد التثبت من صحة الطلب أو تُثبت فشله دون تصحيح الطلب أولاً.

HTTP	المدونة	ماذا تفعل؟
400	`missing_parameter`	البارامترات المطلوبة فارغة أو غير موجودة. تحقق من طاولة البارامترات في نقطة النهاية
403	`invalid_apikey`	ومفتاح API غير معروف أو منتهية أو غير مأذون به بالنسبة للميمة المطلوبة.
429	`too_many_requests`	الطلبات تصل بسرعة انتظر، ثمّ يَعْزلُ بالتراجعِ الهائلِ.
500	`server_error`	ولم تستطع الدائرة إكمال الطلب. الحفاظ على الاستجابة ودعم الاتصال إذا استمر.

قاعدة إعادة التأهيلRetry only transient 429 and 5x responses. ابدأ بعد ثانية واحدة ثم تراجع إلى 2 و 4 و 8 ثواني

هل تحتاج إلى مساعدة؟

أحضري سياق الطلب ليس أسرارك

Share the endpoint, timestamp, HTTP status and sanitized response. لا تشمل أبداً مفاتيح API، أو مداخل أو محتوى الرسائل الخاصة.

الاتصال بشركة API

وثائق نظام إدارة خدمات المشاريع

طلبك الأول في أربع خطوات

الجسر الآمن بين هاتفك ولوحة المعلومات وواجهة برمجة التطبيقات.

تم تقديم SMS عبر API

تم إرسال SMS

فشل SMS

SMS تم استلامه.

SMS أُرسل من الهاتف.

حافظ على أوراق اعتمادك على خادمك

تاريخ واضح بأمان: استعراض أولي، حذف، متابعة التقدم

كيف request_id الأشغال

أمثلة للحذف والوضع

التوثيق بالنسبة لنقاط نهاية التاريخ

اقرأ الرد قبل مواصلة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

حدود

مثال

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

حدود

مثال

حدود

مثال

مثال استقبال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

السطو والمستودعات الآمنة

أحضري سياق الطلب ليس أسرارك