SMSMobileAPI – وثائق واجهة برمجة تطبيقات إدارة المكالمات

وثائق واجهة برمجة تطبيقات إدارة المكالمات

تتيح لك نقاط النهاية هذه استرداد بياناتك المكالمات الفائتة, المكالمات الواردة التي تم الرد عليها، و المكالمات الصادرة تمت المزامنة من تطبيق SMSMobileAPI للهواتف المحمولة إلى لوحة التحكم الخاصة بك + واجهة برمجة التطبيقات (API).

هام: إذا كان تطبيق الهاتف يعمل في الخلفية، فقد يفرض نظام الهاتف تأخيرًا (يصل غالبًا إلى 10 دقائق تقريبًا) بين عمليات المزامنة. يمكنك دائمًا فتح التطبيق للمزامنة يدويًا عند الحاجة.

يدعم: api@smsmobileapi.com

يبحث

التشغيل السريع

عنوان URL الأساسي

يحصلhttps://api.smsmobileapi.com

جميع نقاط النهاية أدناه موثقة على النحو التالي: يحصل الطلبات. استبدال مفتاح واجهة برمجة التطبيقات الخاص بك باستخدام مفتاحك الحقيقي (لا تشاركه علنًا).

أمثلة


GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY


GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc


GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

المصادقة

تستخدم نقاط نهاية إدارة المكالمات المصادقة التالية: أبيكي معلمات الاستعلام.

التحقق من صحة الاشتراك: تقوم نقاط النهاية الواردة/الصادرة بالتحقق من صحة مفتاح API الخاص بك والتحقق من صلاحية اشتراكك (بناءً على dateLimit >= CURDATE()في حال انتهاء صلاحيتها، ستتلقى انتهت صلاحية واجهة برمجة التطبيقاتقد تُرجع نقطة نهاية المكالمات الفائتة خطأً عامًا "مفتاح API مفقود" / أخطاء الخادم اعتمادًا على الظروف.

المفاهيم المشتركة

ترقيم الصفحات

يستخدم حد و إزاحة لتقسيم النتائج إلى صفحات.

الطوابع الزمنية

call_date_ms هو طابع زمني لنظام يونكس أجزاء من الثانية.
call_datetime_utc يتم تخزينها كسلسلة نصية للتاريخ والوقت بتوقيت UTC (حقل قاعدة البيانات).
بالنسبة للمكالمات الفائتة، تُرجع واجهة برمجة التطبيقات (API) رسالة منسقة. تاريخ سلسلة نصية (مشتقة من قيمة بالمللي ثانية).

يبحث

المكالمات الفائتة: يبحث يطابق الرقم أو الاسم.
الوارد/الصادر: q يطابق رقم الهاتف أو الاسم المخزن مؤقتًا.

الفرز (للوارد/الصادر فقط)

يتم التحكم في عملية الفرز بواسطة sort_by + sort_dir (للحقول المسموح بها فقط). يتم ترتيب المكالمات الفائتة دائمًا حسب الأحدث أولًا.

أخطاء

HTTP	مثال على الخطأ	معنى
400	`{"success":false,"error":"missing_apikey"}`	مفقود أو فارغ `أبيكي`.
403	`{"success":false,"error":"invalid_apikey"}`	لم يتم العثور على مفتاح API / لم يتم التعرف عليه.
403	`{"success":false,"error":"api_expired"}`	انتهت صلاحية اشتراكك (`حد التاريخ` (قبل اليوم).
500	`{"success":false,"error":"server_error","detail":"..."}`	خطأ في الخادم (قاعدة البيانات، SQL، استثناء).

ملاحظة: يمكن لنقطة نهاية المكالمات الفائتة أيضًا إرجاع رسائل مثل مفتاح API مفقود أو أخطاء في إعداد SQL حسب الحالة.

قائمة المكالمات الفائتة

استرجاع المكالمات الفائتة التي تمت مزامنتها من الجهاز المحمول.

نقطة النهاية

يحصلhttps://api.smsmobileapi.com/call/missed/list/

معلمات الاستعلام

المعلمة	يكتب	وصف
مطلوب`أبيكي`	خيط	مفتاح API الخاص بك مرتبط بالهاتف المحمول.
خياري`إزاحة`	عدد صحيح	إزاحة الترقيم (الافتراضي: `0`).
خياري`حد`	عدد صحيح	الحد الأقصى للصفوف المطلوب إرجاعها (الافتراضي: `100`، الأعلى: `500`).
خياري`يبحث`	خيط	البحث بالرقم أو الاسم (SQL LIKE).
خياري`تاريخ_البداية`	YYYY-MM-DD	تصفية البيانات من هذا اليوم (00:00:00). مقارنة بالطابع الزمني المخزن بالمللي ثانية.
خياري`تاريخ_نهاية`	YYYY-MM-DD	تمت التصفية حتى هذا اليوم (23:59:59). تمت المقارنة مع الطابع الزمني المخزن بالمللي ثانية.

فرز

تم الإصلاح: الأحدث أولاً (ترتيب حسب التاريخ تنازليًا).

طلب نموذجي


GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

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

{ "success": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "number": "+123470000000", "name": "John Doe", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

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

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

نقطة النهاية

يحصلhttps://api.smsmobileapi.com/call/incoming/list/

معلمات الاستعلام

المعلمة	يكتب	وصف
مطلوب`أبيكي`	خيط	مفتاح API الخاص بك. تم التحقق منه مقابل الاشتراك (`حد التاريخ`).
خياري`حد`	عدد صحيح	عدد الصفوف في الصفحة (الافتراضي: `50`، الحد الأدنى 1، الحد الأقصى `200`).
خياري`إزاحة`	عدد صحيح	إزاحة الترقيم (الافتراضي: `0`).
خياري`sort_by`	خيط	حقل الفرز (الافتراضي: `call_date_ms`). مسموح: `call_date_ms`, `call_datetime_utc`, `المدة_ثانية`, `رقم التليفون`, `تم إنشاؤه في`, `الاسم المخزن مؤقتًا`, `تحديد الموقع الجغرافي`.
خياري`sort_dir`	صعود\| هبوط	اتجاه الفرز (الافتراضي: `الوصف`).
خياري`تاريخ_من_مللي_ثانية`	عدد صحيح (مللي ثانية)	تصفية حيث `تاريخ_الاتصال_بالمللي_ثانية >= تاريخ_البداية_بالمللي_ثانية`.
خياري`date_to_ms`	عدد صحيح (مللي ثانية)	تصفية حيث `call_date_ms <= date_to_ms`.
خياري`q`	خيط	ابحث (أعجبني) على `رقم التليفون` أو `الاسم المخزن مؤقتًا`.

طلب نموذجي


GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

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

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:38" } ] }

قائمة المكالمات الصادرة

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

نقطة النهاية

يحصلhttps://api.smsmobileapi.com/call/outgoing/list/

معلمات الاستعلام

نفس المعايير والسلوكيات الخاصة بالمكالمات الواردة.

المعلمة	يكتب	وصف
مطلوب`أبيكي`	خيط	مفتاح API الخاص بك. تم التحقق منه مقابل الاشتراك (`حد التاريخ`).
خياري`حد`	عدد صحيح	عدد الصفوف في الصفحة (الافتراضي: `50`، الأعلى `200`).
خياري`إزاحة`	عدد صحيح	إزاحة الترقيم (الافتراضي: `0`).
خياري`sort_by`	خيط	تقصير `call_date_ms`. مسموح: `call_date_ms`, `call_datetime_utc`, `المدة_ثانية`, `رقم التليفون`, `تم إنشاؤه في`, `الاسم المخزن مؤقتًا`, `تحديد الموقع الجغرافي`.
خياري`sort_dir`	صعود\| هبوط	تقصير `الوصف`.
خياري`تاريخ_من_مللي_ثانية`	عدد صحيح (مللي ثانية)	قم بالتصفية من هذا الطابع الزمني (بالمللي ثانية).
خياري`date_to_ms`	عدد صحيح (مللي ثانية)	قم بالتصفية حتى هذا الطابع الزمني (بالمللي ثانية).
خياري`q`	خيط	ابحث عن `رقم التليفون` أو `الاسم المخزن مؤقتًا`.

طلب نموذجي


GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

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

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:37" } ] }

حقول المكالمات الفائتة

مجال	يكتب	وصف
`نجاح`	منطقي	حالة الطلب.
`إزاحة`	عدد صحيح	تم إرجاع إزاحة الترقيم.
`حد`	عدد صحيح	تم إرجاع الحد الأقصى لعدد الصفحات.
`عدد`	عدد صحيح	عدد الصفوف المُعادة في `بيانات`.
`بيانات`	مصفوفة	قائمة المكالمات الفائتة.
`data[].number`	خيط	رقم هاتف المتصل.
`اسم البيانات[].`	خيط	اسم جهة الاتصال المخزن مؤقتًا (قد يكون فارغًا).
`تاريخ البيانات[].`	خيط	سلسلة التاريخ والوقت المنسقة والمستمدة من طابع زمني بالمللي ثانية.

الحقول الواردة/الصادرة

مجال	يكتب	وصف
`نجاح`	منطقي	حالة الطلب.
`أبيكي`	خيط	تم إعادة إرسالها بواسطة واجهة برمجة التطبيقات (مفتاحك).
`حد`	عدد صحيح	عدد الصفوف في الصفحة الواحدة.
`إزاحة`	عدد صحيح	تم إرجاع إزاحة الترقيم.
`sort_by`	خيط	تم تطبيق حقل الفرز.
`sort_dir`	خيط	تم تطبيق اتجاه الفرز.
`الفلاتر`	هدف	المرشحات المكررة (`تاريخ_من_مللي_ثانية`, `date_to_ms`, `q`).
`عدد`	عدد صحيح	عدد الصفوف المُعادة في `صفوف`.
`صفوف`	مصفوفة	قائمة المكالمات.
`rows[].phone_number`	خيط	رقم التليفون.
`rows[].cached_name`	سلسلة نصية\|لا شيء	اسم جهة الاتصال المخزن مؤقتًا (يمكن أن يكون فارغًا).
`rows[].call_date_ms`	عدد صحيح	الطابع الزمني للمكالمة بالمللي ثانية.
`rows[].call_datetime_utc`	خيط	حقل التاريخ والوقت بتوقيت UTC (قاعدة البيانات).
`rows[].duration_sec`	عدد صحيح	المدة بالثواني.
`rows[].geo_location`	سلسلة نصية\|لا شيء	تسمية الموقع الجغرافي (يمكن أن تكون فارغة).
`rows[].created_at`	خيط	الطابع الزمني لإدخال الخادم.

وثائق API والمطور

سجل الأدوات والتغييرات

وثائق واجهة برمجة تطبيقات إدارة المكالمات

التشغيل السريع

عنوان URL الأساسي

أمثلة

المصادقة

المفاهيم المشتركة

ترقيم الصفحات

الطوابع الزمنية

يبحث

الفرز (للوارد/الصادر فقط)

أخطاء

قائمة المكالمات الفائتة

نقطة النهاية

معلمات الاستعلام

فرز

طلب نموذجي

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

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

نقطة النهاية

معلمات الاستعلام

طلب نموذجي

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

قائمة المكالمات الصادرة

نقطة النهاية

معلمات الاستعلام

طلب نموذجي

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

حقول المكالمات الفائتة

الحقول الواردة/الصادرة

💬 الدردشة المباشرة متاحة