مكالمة تطوير الوثائق - واجهة برمجة تطبيقات الرسائل النصية القصيرة عبر الهاتف المحمول
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()في حال انتهاء صلاحيتها، ستتلقى انتهت صلاحية واجهة برمجة التطبيقات.

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

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

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

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

  • 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).

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

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

نقطة النهاية

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

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

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

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

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

نقطة النهاية

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

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

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

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

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

مجاليكتبوصف
نجاحمنطقيحالة الطلب.
إزاحةعدد صحيحتم إرجاع إزاحة الترقيم.
حدعدد صحيحتم إرجاع الحد الأقصى لعدد الصفحات.
عددعدد صحيحعدد الصفوف المُعادة في بيانات.
بياناتمصفوفةقائمة المكالمات الفائتة.
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@smsmobileapi.com
نصيحة: لا تنشر مفتاح API الخاص بك في لقطات الشاشة أو التذاكر أو المستودعات العامة.
💬 الدردشة المباشرة
💬 الدردشة المباشرة متاحة
هل لديك أي أسئلة أو تحتاج إلى مساعدة؟
فريقنا هنا لمساعدتك!
أدخل عنوان بريدك الإلكتروني
لمساعدتنا في متابعة طلبك:
لوحة القيادة