مكالمة تطوير الوثائق - واجهة برمجة تطبيقات الرسائل النصية القصيرة عبر الهاتف المحمول

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

عنوان 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=1555&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).

طلب نموذجي

GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&offset=0&limit=100

مثال على استجابة JSON

{ "success": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "number": "+15551230001", "name": "", "date": "2026-03-20 16:12:28" }, { "number": "+15551230002", "name": "Alex Carter", "date": "2026-03-20 16:12:00" }, { "number": "+447700900123", "name": "Taylor Reed", "date": "2026-03-20 15:48:41" } ] }

شرح الاستجابة

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

القيم المذكورة أعلاه هي أمثلة تم إخفاء هوية أصحابها. قد تحتوي الردود الحقيقية على أرقام هواتف ومعلومات اتصال مختلفة.

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

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

نقطة النهاية

يحصل 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	خيط	خياري ابحث عن رقم التليفون أو الاسم المخزن مؤقتًا (يحب).

طلب نموذجي

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

مثال على استجابة JSON

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230010", "cached_name": "Jordan Blake", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Canada", "created_at": "2026-03-20 17:46:45" }, { { "phone_number": "+15551230011", "cached_name": "Morgan Lee", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Canada", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Sam Parker", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Canada", "created_at": "2026-03-20 12:59:01" } ] }

شرح الاستجابة

مجال	وصف
نجاح	حقيقي هذا يعني أنه تمت معالجة الطلب بنجاح.
أبيكي	تم إعادة إنتاج قيمة مفتاح API. في أمثلة التوثيق، يجب إخفاء هذه القيمة دائمًا.
حد	عدد الصفوف المطلوبة لكل صفحة.
إزاحة	إزاحة الترقيم التي تُرجعها واجهة برمجة التطبيقات (API).
sort_by	حقل الفرز الذي تم تطبيقه بواسطة واجهة برمجة التطبيقات (API).
sort_dir	يتم تطبيق اتجاه الفرز بواسطة واجهة برمجة التطبيقات (API).
الفلاتر	كائن يحتوي على عوامل التصفية النشطة المستخدمة في الطلب.
عدد	عدد الصفوف المُعادة في صفوف.
صفوف	مصفوفة تحتوي على سجلات المكالمات الواردة التي تم الرد عليها.
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) أن تعكس ما يلي: أبيكي في الرد. في الوثائق العامة ولقطات الشاشة والأمثلة، قم بإخفائها دائمًا.

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

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

نقطة النهاية

يحصل 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	خيط	خياري ابحث عن رقم التليفون أو الاسم المخزن مؤقتًا (يحب).

طلب نموذجي

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

مثال على استجابة JSON

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230020", "cached_name": "Casey Morgan", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Canada", "created_at": "2026-03-20 17:17:58" }, { { "phone_number": "+15551230021", "cached_name": "Taylor Brooks", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Canada", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Jamie Carter", "call_date_ms": 1774019040000, "call_datetime_utc": "2026-03-20 15:04:00", "duration_sec": 61, "geo_location": "Canada", "created_at": "2026-03-20 15:09:11" } ] }

شرح الاستجابة

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

القيم المذكورة أعلاه هي قيم مجهولة المصدر. استبدلها ببياناتك الحقيقية فقط في الأدوات الخاصة/الداخلية، وليس في الوثائق العامة.

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

مجال	يكتب	وصف
نجاح	منطقي	حالة الطلب.
إزاحة	عدد صحيح	تم إرجاع إزاحة الترقيم.
حد	عدد صحيح	تم إرجاع الحد الأقصى لعدد الصفحات.
عدد	عدد صحيح	عدد الصفوف المُعادة في بيانات.
بيانات	مصفوفة	قائمة المكالمات الفائتة.
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 الأساسي

أمثلة

المصادقة

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

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

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

يبحث

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

أخطاء

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

نقطة النهاية

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

طلب نموذجي

مثال على استجابة JSON

شرح الاستجابة

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

نقطة النهاية

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

طلب نموذجي

مثال على استجابة JSON

شرح الاستجابة

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

نقطة النهاية

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

طلب نموذجي

مثال على استجابة JSON

شرح الاستجابة

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

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

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